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INTROOUCTION 


Sort/uUtility witl perform all of the functions of IBM's SsDSORT 
program. Specifications may be given in free format» as in the 
SORT language» or in the fixed field format of SDSORT. 


A selected subset of the input records may be processed. Records: 
of an input file may be included or exctuded from sort Ecosse 09 
depending on selected conditions. | 


The format and contents of the output records may differ from the 
input appearance. Fields in a record may be rearranged or 
excluded. Characters may be forced into chosen positions. 
Selected fields may be summed together to provide user processing 
during the sort run. 


Different record foraats may be specified within the same output 
file... Selected criteria witl determine the arrangement and 
selection of fields in arecords» and there may be nugerous' sets 
of criteria for one output file. 7 


The order of the output file may be controlled by the user. 
Records may be sorted in ascending or descending order. The 
normal collating sequence can be altered to allow the ordinal 
value of a character to be controlted. 


In additions Sort/Utility has the ability to handle right or left 
Signed» packed or unpacked fields. . Character or numeric type 
data may be specified. Also» zone or digit portions of 
characters may be used. | 
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FREE EQRMAT SPECIFICATIONS 


This section of the document discusses the use of free format 
specifications. The free format syntax is given initially» with 
abbreviation definitions immediately following. Exaaptes of each 
type of free format statement are also given. Those statements 
preceded by the symbol “>* are combined into a sample execution 
of SORT/UTILITY. The equivalent fixed format syntax is given in 
the final example. 


The free format syntax has some extensions to the capabilities 
allowable in fixed format. Character constants are restricted 
onty by record size in free format. The unsigned numerics UN» 
packed data type exists oniy in free format. The ZIP» RESTART» 


TIMING and STABLE options exist only in free format syntax. 


The TEACH option witl produce equivalent free format 
specifications to any given input specifications. It is designed 
to aid in converting fixed format to free format syntax. 


There is no specific restriction on the number of Record and 


Field type statements that may be specified. The Limiting factor 


is the amount of dynamic memory available» as this is where the 
information is stored. | | 


The entire input record size is used for interpreting free format 


inputs therefore» there must be no sequence numbers in the input 
file specifications. 


pera aos 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP B1800/B17090 SORT/UTILITY 


SANTA BARBARA PLANT oe P.S. 2222 2562 CA) 


SPECIAL OPTIONS | 
(May be specified only once) 
NOPRINT. don’t prints must be the first token 


FILE IN {<name>] (<in.part>{<ctoseetypesin>])... name & attributes 
~—OUT C<name>) (<out.part>{<claose.type-out>J)) 1716 INS & 1 OUT 


COLLATE € FILE (<name>) } name of external collate file 
| { (€ <collate constant> ) } collating sequence to be used 
ZIP *"<ltit>*" Zipped at EOJ 


CONTROL SPECIFICATIONS 


(May be specified only onces with the exception of "FIXED" and "z™) 


rest of line contains a comment 


NOSORT _ , & | don't sort | 
DROP CONTROL | | don't keep control fietds in output records 
CONTROL: <tnt> maximum key fieid Length | | 
TEACH (C€<name>)] print the free format equivalents and 

: 3 optionally save on disk 

MECmory] <int> dynamic memory to be used in bytes 

SUMMARIZE | add summarydata fields of dupticate records 
RESTART C<int>] ake restartable or restart job number <int> 
TAGSORT output is a tagfile of 8-digit packed decimals 
STABLE duplicate records retain input order 

FIXED (<int>] ** Read att or next <int> cards as fixed format 
SYNTAX check spec cards for syntax onty 

TIMING : print VSORT timing report 


**Must be the only specification appearing on its input record 
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RECORD IYPE SPECIEICATIONS 


(Record selection and record type definition) 


INCLUDE €(<disp>CEQL*] "eLit>"L<length>]0<type>]) CAND] .c.J.0~ 
DELETE CNEQ 1] a<hex>a 1* UA* COR*) oe 
(LSS 

{GTR 

{LEQ 

{GEQ 


#<num>f# 
<disp> 


teach tend ted teed 


* Denotes default value 


FIELD SPECIFICATIONS 


(Qutput record description of each record type) 


KEY. ( <disp> <length> (<order>] (<type>] ) ee. 


Ax UA* 
FORCEKEY CREMAPS] ( L<disp> <const>] <const> C<order>] CUA*] ) eee 
| | Ax CALPHA] 
(ZONED 
(DIGIT) 


DATA ( <disp> <length> (<type>] ) ec. 
| | UA* 
FORCEDATA (€ <const> ) eos 


SUMMARYDATA C <disp> <length> (<type>] (<overflow length>] ) e«-« 
| UA* | - | 
OVERFLOW CC <const> C<const>] )]- 


* Denotes default value 
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ABBREVIATIONS AND EXPLANATIONS 


<inepart> = 4 <har> <rsz> (<rpb>] CMULTI CVC <max>)] } 
| awe F CVARTABLE) | 
: { DISK DEFAULT } 
<out.epart> = ¢ <har> <rsz> (<rpb>] CHULTIICVC<max>)) } 
— | CVARIABLE) | 
{ DISK DEFAULT | : } 


<name> = a file name according to MCP file naming conventions» 
except left and right parentheses must be in quotes 


<disp> and <length> = integer bytes such that displacement 
7 | . plus tength is tess than 8192 


<const> = "<lit>”" or a<hex>a 

<cotlate constant> = "<lit>™ or aL(<hexpair>) l<hexpair>(-<hexpair>1a 
<hexpair> = a pair of saniate <hex> characters | 
<type> = ALPHA*«>» UA®> NUMERICs UN» SA» RSA» SNe RSN» ZONE» or DIGIT 
eeeies = ASCENDING or A>» DESCENDING or D 


<lit> = any ES8CDIC character(s). Two adjacent quotes denote one quote. 


<hex> = any character(s) 0°9 and Aw F 
<int> = any unsigned integer 
<num> = any signed integer 
| Seas = record size in bytes 
hare hardware: DISK ( <disk.part> )» PACK ( <disk.part> )» 
TAPE € € <tapeepart> ) J» CARD» CARDS or PRINTER 
; <disk.part> = disk attributes: <records per area> {<number of areas>] 


<tape.part> = tape attribute: Us DDD» Es or EVENS implies 7 track 
<rpb> = records per btock _ 

ewaus 2 wane aue- block size in bytes 

<overflow tength> = field length + overflow Length tn bytes 
<close.type.in> = PURGE 


<€close.typeeout> = RELEASE 
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EXAMPLES 

ee The right arrow denotes statements used in the saaple 


SORT job found in the EXAMPLE at the end of this section. 


Header Iype Cards 


NOPRINT 


Requests that no listing of the input cards be generated. If 

this instruction is left out a Listing will be generated. If 
an error is found the specification cards and errors” are 
Listed from that point on. 


—NOSORT 


Do not sort the _ file>» just create the output file as 


specified. If this instruction is left out» a sort is 
performed. — | 
DROP CONTROL 

This requests that the key fields» (Ci.e@e» fields specified 
with the KEY and FORCEKEY statements)» be dropped from the 


output records. If this instruction is not given» the key 
fields will be included in the output file records. 


>CONTROL & 


The maximum control field length of any record type is 
specified as 6 bytes. : | 


TEACH 
Print the free format equivalent of the input specifications. 


TEACH (<filenamel>) 


Print the free format equivalent of the input specifications 
and save them on disk as file <filenamel>- 
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>MEMORY 12000 


The default memory for the sort phase is 8»000 bytes. Any 
integer specified» greater than 8-000- wilt be used as the 
memory size. In this instances 12000 bytes of memory will 


be used. 


ME <integer> 


Same as MEMORY. 


> SUMMARIZE 


Perfor a sort suamarizing the SUMMARYDATA fields. 
SUMMARYDATA fields occuring in records with duplicate control 
fields will be added together. 


RESTART 


Restart information is kept. 


Roun! 2080 


Restart the job with parent job nuaber 2080. 


TAGSORT 


Create a tag file of relative record numbers» 4 bytes per 
record. | 


STABLE 


Records with duplicate keys are output in the same order in 
which they were tnput. | 


ZIP "EX DMPALL* 


The command is ZIP=ped to the MCP at the end of the job. 
Before terainatings SORT/UTILITY witl ZIP "EX DMPALL” string. 


FIXED 


The rest of the input is in fixed format. 
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FIXED 5 


The next five cards of input are in fixed format. 
FILE IN <file namel> (TAPE 19) IN CTAPE 19) IN <file name3> 
CTAPE 10 PURGE) OUT <filename4> CTAPE 10) 
Specifies that there are three input files and one output 


file on tapes with record sizes of 10 bytese The third input 


file» <file name3>» is to be closed purge. The second tnput 
file will te unlabeled. 


FILE IN <file namel> (DISK 60 MULTI VC(1900) PURGE) 


One input file is specified. It is on disk with a record 


size of 80 bytes. It is a multiple pack file with variable 
length records. The maximum btock size is 1909 bytes. The | 


file is to be ctosed purge. No output file attributes are 
specified. | 


>FILE out <fite namel> (DISK DEFAULT) IN <file name2> (DISK DEFAULT) 


One input file on disk and. one output fite on disk are 
specified. Their file attributes wilt default to the file 
header' s attributes. 


FILE OUT <file namel> CDISK 80 RELEASE) 


No input files are specified. One output file on disk with a 
record size of 80 bytes is pecvelen: It 15 to be ctosed 
release. ! | 


NOTES: 


1. Specifying an output fite to be closed purge is not 
valid. 


2. $.If any input or output file is specified as variables att 
input and output files must be variable. 


3. The. order of the IN and OUT bares of the FILE statement 
is not restricted. 


4. File names follow standard 81800/B1700 file naming 
— - conventionss except that left and right parenthesis must 
be in quotes. 3 - | | | 


5» The file statement is optional. File equates specified 
at execution time will override file statement 
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specifications. Missing attributes witli be given SOL 
defaults untess the file is on disk. In this case the 
attributes will come from the disk file header. The SOL 

defaults witl be taken from the FSP of a file with the 

internal name of “DEFAULT”. (See File Attribute 


Assignment Precedence.) 


One to sixteen input files are allowable in SORT/UTILITY. 
In order for SORT/UTILITY to recognize that a file is to 
be inctuded in a SORT/UTILITY execution» either the name 
field» FPB.NAMES» or the hardware type field» FPB.HOWR>» 
must be altered in the files corresponding FPB. The 
internal file names for these files are: INPUT» INPUT2» 
INPUT 3.e2eeINPUT1I6. . 
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Record Type Cards 


INCLUDE (1 "2™) 


If the value of the data beginning in byte position 1 of 
length one byte and type unsigned atpha is equat to the 
constant "2" of the same type and tength » include this 
record in the sort. © Therefore» the first record would be 
included and the second would not. | 


INCLUDE (1 LSS 40) 


If the value of the data beginning in byte position 1 with a 
length of one byte is tess than the data beginning in byte 
position 40 with the same tength» inctude this record in the 
sort. Both fields are defined to be unsigned alpha. Since 
neither a "2" or a “3" is less than "0" neither record would 
be included. | : 7 


INCLUDE (5 NEQ "8B" 2) 


Sort all records that do not contain the constant "88" in, 
byte position 5 for tength 2 where the constant and the 
comparison fietd are of type unsigned aipha (the default). 
Therefore» both records would be sorted. | | | 


INCLUDE (13 GTR 17 4& UN) 


If the value of the data beginning in digit pcsition 13 of 
length 2 bytes (4 digits) and type unsigned numeric is 
greater than the vatue of the data beginning in digit 
position 17 with the same tength and type» include this 
record in the sort. Therefore» since 299322 is greater then 
909012 and 200024a both records would be included in the sort. 


INCLUDE (51 EQL #-228# 4 RSN) 


Sort alt records containing 7228 beginning in digit position 
51 for tength 2 bytes (4 digits)? where °-228 and the 
comparison field are of type right signed numeric» denoting 
packed specification. The number wilt be converted to a 
packed format. Both records contain “228 in digit position. 
51 in packed» right signed numeric format. Therefore» both 
records are included in the sort. | | 
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>INCLUDE (30 LEQ #24524 5 RSA) 


Sort. alt records with a value tess than or equal to the 
number 2452 in byte position 30 for tength 5 bytes. The 
constant 2452 and the coaparison field are of type right 
signed alpha» denoting unpacked speci fication. The tength is 
coaputed in 8 bit bytes. The sign in this example is assumed 
to be positive and will be added on the right. Both positive 
2452 and negative 2453 are less than or equat to positive 
2452 and both records will be included in the sort. 


INCLUDE (51 GEQ@ 222803 4 RSN) AND (40 GEQ "000001" 6 UA) 


If the value of the field beginning in position 51 of Length 
2 bytes (4 digits) and type right signed numeric is greater 

than or equal to -228» and the value of the field beginning 
in position 49 of length 6 bytes and type unsigned atpha is 
greater than or equal to the string "000001"» then include 
the record in the sorte Both conditions must be satisfied to 
qualify a record for sorting. The constant 2228Da denotes 
the actual contents of the data field. In this examples both 
records will be included in the sort as they both satisfy the 
two conditions specified. 


INCLUDE (30 EQL aF5F2a 5 RSA) OR (35 EQL “LAST™ 5) 


If the value of the field beginning in byte position 30 of. 
Length 5 bytes and type signed atpha is equal to 52s 
Cright-justified» zero filled)» or if the value of the field 
beginning in byte position 35 of length 5 bytes and type 
unsigned alpha is equal to “LAST "» (Cleft-justified» blank 


filled)» then include the record in the sort. Qne of these 
two conditions must be satisfied if a record is to be 
tncluded tn the sort. In this example» neither record witt 


be included in the sort as neither record contains the vatue 
52 in positions 39 through 34,5 or the string "LAST “ in 
positions 35 through 39. 


NOTES: 

1. The word AND" in this context denotes a continued 
condition. The word “OR” denotes a new condition. If 
all conditions are true when an “OR™ is reached» the 


current record 1s assumed to belong to the current group. 
{If a false condition occurs when an “AND” is reached» the 
"AND" statements are skipped and processing continues 
with the next "OR" statement. | | 


2e A time savings can be realized if INCLUDE statements can 
be organized into "groups". A “group” consists of any 
consecutive INCLUDE statements that have  tike 
displ acement » length» type» have a relation of equal, 
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C"EQL™)» and refer to a constant for factor-d- They must 
not be connected by “AND"s. | 


‘DELETE. 


The format for DELETE is the same as for INCLUDE. 
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Field Iype Cards 


>KEY (35 5) 


KEY 


KEY 


KEY 


This key field begins in byte position 35 of the input file. 
It is 5 bytes in length and unsigned alpha type. It is to be 
sorted in ascending order. In thig example the first record 


would sort before the second record since "FIRST" is of lower 


value than "“SECND". 


(35 5D) 


This key field begins in byte position 35 of the input file. 


It is of length 5 bytes and type unsigned atphae It is to be 
sorted in descending» OD» order. In this example the second 


record would sort before the first record» since "SECND™ is 


of higher value than "FIRST". 


(305 A RSA) 


This key field begins in byte position 30 of the input file. 
It is of length 5 bytes and type right signed alpha. It is 
to be sorted in ascending» A» order. There fore» the second 
record witl sort before the first record since 2453 1s of 
less value then 2452. 


(51 4 0 RSN) (35 5) 


There are two key fields. The first key begins in digit 
position 51 of the input file. It is 2 bytes (4 digits) in 
Length and of type right signed numeric. It is to be sorted 

in descending order. The second key begins tn byte position. 
35 of the input fite. It is of length 5 bytes and type 
unsigned alpha. It is to be sorted in ascending order. 
Therefores since the value of the field beginning in digit. 


position S51 is the same (-228) in both records» the second 


key then further determines the order of the records. In 
this case the first record will sort west? as “FIRST” is of 
less value than *“SECND®*. 


“RRM GSH in Wee pee 2 
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FORCEKEY statements always define one byte of the output record. 


FORCEKEY ("A") 


Unconditionatty> the character “A™ is placed tnto the next 
byte position in the output record. It forms a new key fietd 
one byte in pengene to be sorted in ascending order. : 


>FORCEKEY (1 aF2a "A™ ALPHA) 


If the character in byte position 1 of the input record is. 
equal to a "2" (2@F22)» place an “A* in the next byte position 
in the output record. Otherwise» since the key is sorted in 
ascending (default) orders aFF2 is placed in this position. 
A descending key would cause 2002 to be supplied. Thuss the 
first record would cause an "A" to be placed in its 
corresponding output record. The second record would cause 
aFFa to be entered. 


FORCEKEY (2 "2" "A" A ALPHAD REMAPS C2 "0" "B"™ A ZONE) REMAPS 


<7 C™ AD 


In this case» each condition applies to the same byte 
position in the output record which is the next position. If 
the character in byte position 1 of the input record is equal 
to "2" then place an “A™ in the output record. If it is not 
equal to “2%, and if the zone portion (leftmost 4 bits) of 
the character in position 2 of the input record is equal to 
the zone portion of the character "0" (3F92)» ptace a "8" in 


this position of the output record. If neither of these | 
first conditions are true» place a *C™ in the output record. 
Thuse the first record would cause an "A" to be output and 


the second record would cause a "B" to be output. In every 
case the resulting key will be sorted in ascending order. 


FORCEKEY (i "2" "A" D) REMAPS (2 "0" "B" O DIGIT) (5 7A™ *Z" UA) 


The # first two conditions described in this “"FORCEKEY® 
statement pertain to the same byte position in the output 
file record. The third condition pertains to the next byte 
due to the tack of the word “REMAPS*. If the character in 
byte position 1 of the input record is equal to a "2" then 

place an “A*™* into the current byte position of the output 
record. If it ts not a "2", and if the digit portion 
(rightmost 4 bits) of the character in position 2 of the 
input record ts equal to the digit portion of the character 

"0" €203) place a "8B" in this position of the output record. 
Otherwiser 32002 will be entered since the ney is to be sorted 
in cescenorng order. | 
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The third condition causes the current output record position 
to be updated by one byte. It states that if the character 
in byte position 5 of the input record is an “A"™ place a “Z* 
in the new position of the input record. Otherwise» 2062 is 
entered as described above. — - | 


Therefore» the first record causes an "A" and a “Z" to be 
placed in its corresponding output record. The second record 
causes a “B" and a "Z" to be output. | | , 


>FORCEKEY REMAPS (1 "2" "A" ALPHA) REMAPS CL @aFO2 @C2a ALPHA) 
REMAPS C("C*) 


The word “*REMAPS®" states that all force character conditions 
apply to the preceding specified key output position. 
Therefores this statement aust follow a "KEY" or a "FORCEKEY* 
statement. The first condition states that if the character 
in byte position 1 of the input file record is equal to “"2"» 
then "A™" is put tin the last byte position specified in the 
previous key stateasent. Condition two states that if the 
character beginning in digit position 1 of the input file 

record its equat to "0" (Q2F0a)» then a "8" (€3C22) is put iin 
the same position in the output record. The third condition 
states that if neither of the previous conditions is true» a 
*“c" is placed in this same position of the output file 
record. This field witl be sorted in ascending order (the 
default). | | 
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DATA (1 6) 

One output record field is described. The data fietd 


beginning in byte position 1 of the input record with tength 
6 bytes and type unsigned alpha is to begin in the next 
position of the output record and given the same length = and 
type. | | | : 


>DATA (7 4 ZONE) 


One output record field is described. The data fietd 

beginning in byte position 7 of the input record with tlength 

4 bytes and type ZONE is to begin in the next position of the 

output record and given the same tength and type. The fietd 
as prefilled with a40a%s and only the zones are aoved. 


DATA (49 2 SN) C11 14 DIGIT) 


Two output record fietds are described here. The data field 
beginning in digit position 49 of the input record with 
length i byte (2 digits) and type signed numeric» is to be 
placed in the next byte of the output record and assigned a 
type of signed numeric. The data field beginning in byte 
position 11 of the input record with length 14 bytes and type 
digit» is to begin in the next position of the output record 
and given the same length and type. The field is prefilled 
with @F0A's and onty the digits are moved. | : 
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>FORCEDATA ("4") 


The use of FORCEDATA iaplies that an unconditional force to 
the next output byte position is to be performed. One 
unconditional force is specified. The constant *4" of type 
unsigned alpha is to be moved to the next output record byte 
position.e 


FORCEDATA ("4") Cacia) 


In this case» the constant "4"» of type unsigned alpha» is to 
be placed in the next output record byte position. fhe 
constant "A" (aC1a) of type unsigned alpha is to be placed in 
the next output record byte position foltowing the %4&*. 


ty 


SCM TE BE a err sy eereen srssgcre rps te ts 
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SUMMARKYDATA (1 4) 

The field beginning in byte position 1 of the input record, 
with tlength 4 bytes and type unsigned alpha ts to be 
Summarized» (Cadded together)» during a summary sort. The 
maximum size allowed for the output field ts 4 bytes. There 
will be no duplicate keys in the output file. During SORTR 
type of sort» the field will not be summarized and witt thus 
be treated as a DATA specification. During an ADDROUT sort 
the field is ignored. > 7 oO | 


—>SUMMARYDATA C(i3 4 SN)- 


The field beginning in byte digit position 13 of the input 
records with length 2 bytes ¢€4 digits) and type signed 
numerics is to be summarized during a summary sort. The 
maximum size altowed for the output field is 2 bytes. There 
wilt be no duplicate keys in the output file. Ouring a SORTR 
type of sorts» the field will not be summarized and wilt thus 
be treated as a DATA speci fication. During an ADDROUT sort 
this field 31s tgnored. 


SUMMARYDATA (51 4 SN 8) 


The field beginning in digit position 51 of the input record 
with length 2 bytes (4 digits) and type signed numeric is to 
be summarized during a summary sort. The maximum stze 
allowed for the output field is 4 bytes (8 digits). There 
wilt be no duplicate keys in the output file . During a 
SORTR type of sort» the field is not summarized and will be 

treated as a DATA specification. | Ouring an ADDROUT sort 
these fields are ignored. | 


SUMMARYDATA (51 4 SN 8) (C1 4) 


Same as the above examples» though two SUMMARYDATA fields are 
specified here. | 


NOTES: 


1-e %In a summary sorts the SUMMARYDATA fields must be in the 
same position for all record types. The fields do not 
have to refer to the same position in the input file. 


2- The first record type description containing summary 
speci fications defines the summary format for att 
included records of any type. It is recommended that all 
record type descriptions contain summary specifications 
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if one of them does. If a record type description does 
not contain summary specifications» the data 
specification should atign the data for summarization. 
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OVERFLOW 


If overflow occurs in any SUMMARYDATA field» the next byte 


position in the output record witl contain an “**". If no 


fields overflows a blank will be placed in this position. 


OVERFLOW ("0") 


Lf overflow occurs in any SUMMARYDATA field» the next byte 
position in the output record witlk contain the constant “0”. 
If no fields overflow, a blank will be ptaced in this 


position.| 


>OVERFLOW ("%*"™ VN") 


If overflow occurs in any SUMMARYDATA field» the next byte 
position in the output record witl contain an “*". If no 
fields overflows "N" will be placed in this position. | 


OVERFLOW (3D6a "N") 


If overflow occurs in any SUMMARYDATA field» the next byte 
position in the output record witl contain the constant "O0">» 
(ie. a069).- If no fields overflows» “"N™ will be ptaced in 
this position. | : 


NOTES: 


le Qnty one overflow indicator may be defined for alt record 
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- EXAMPLE 
‘Input Data 
Leiokeacowewas segs 10 6acs sail new sacs ce ies ce dese eesosciee 50 sceees se 55 
2044AA- THISISTHEFIRS TS O2452F 


F2FOF 4F4C1C100320001E 3CBC IEZC IE ZE 3C BC 5CBC INDIE 2ZE 361 2280005 0F OF ZF 4F SF2C6 


$6 oicecshOssseceuslseaecieeec50 
IrRestog00go0 tt (first record) 
CIDIEZESFOFOF OFOFOFLOO0003000F | 


betcats sD sees tuewsl 0sedosdwel Siceeesseelscuaeses2 0 esceiwe< 30saeceees 55 


$SO32A4AA THIS TSTHE SECON ODO 9 245U 5 
FSFOF SF2CIC1LOO3S2000Z2E SCB8CIECCIEZE SCBCSE2C SCID 605C 42280004 OF OF ZF SF SDSE2 


56s oases RN wawlesic cho escusssc50 - 
ECNOD000002 — (second record) 
CSCSO5C4EFOFOF OFOF OF 20000030010D 


Sort/Utility Language 


FILE out <file namel> (COISK DEFAULT) IN <file name2> CDISK DEFAULT) 
MEMORY 12000 
CONTROL 6 
SUMMARIZE 
INCLUDEC30O LEQ #245284 5 RSA) 
KEY (35 5) 
FORCEKEY REMAPS (1 "27° *A™ ALPHA) REMAPS (1 oes aC22 ALPHA) 
REMAPS ("CC") : 
(1 aF2a "A™ ALPHA) 
DATA (7 4 ZONE) 


 - FORCEDATA ("74") 


SUMMARYDATA (13 4 SN) 
GVERFLOW (C™«*" "NT) 
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Fixed format Equivatent 


a 2 2 3 
Ba ccc cD cc ed coe eDeceeDdece cde 
QOOHSORTSRS 6A 14 


O1UI U 30 34LEC02452 


O70FNC 35 39 


Q80FFC — «12AX 
NI0FFC 108X 
LOOFFC rs. 
110FFC 12A 
120FDZ 7 10 
130FDV P 
140FSP 7 8 


LSOFSV «N 


Resulting Gutput Records 


Lececccadecesecos ‘ee 1 ese. ee eretelk 


FIRSAA 4 N 

C6CI9DIEZCIC100300000F 4003205 (first record) 
LeccesceDdaces ece el saineesaeto 

S ECNC 4 N 


E2C5C3D5C 3FF00300000F 4003205 (second record) 
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ELXEO EQRMAT SPECIFICATIONS 


This section of the document discusses the various types of disk 
sort specifications that are allowed in fixed format. The coluan 
number appears at the ieftthand side of the page and the 


description of the function of that column follows. Where a 
fixed format entry is restricted in combination with other 
entries» a statement of the restrictions occurs. The EXAMPLE at 


the end of Section 2 uses some fixed format specifications. 3 


There is no specific restriction on the number of Record and 


Field type statements that may be specified. The limiting factor 
is the amount of dynamic memory available» as this is where the 
information 1s stored. 
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COLUMN SUMMARY = HEADER SPECIFICATIONS 


porwr ceaee | oe wee wwee |] wee ewww acee > a” on an an oe ak a on oe @ Sees es Sse os a a of 
ICOLUMNS! ENTRIES #§ EXPLANATION | i 
(eeieson | Ses ee es's= |e ee eee = ee = — am a a aaunwe ae a a cena mw oe we | 
fies 900000 ! Page and line number i 
{we wew as fj wm ew wwe eawe jf we wmee — 2 as 6 am an ae an ae mewn anon ae mam a mw ae | 
| 6 tH { Header Line identification d 
prec ee ee | ww ewe econ | cower awaow awe cma eas were amen eases | 
41 7-12 1 SORTA 1 Addrout sort job i 
t Peer ee a Sa ee ee eee <_ an oe a ee a me an a ee ecwocnmae | 
{ i SORTR 1 Tag along sort job | : 
| eres eres [aS ees eee sess Sees 4s SS aS See Se eee ee =| 
1 ! SORTRS ¢ Su@mary tag along sort job 7 { 
J we ween | ome wee cee [weet ewe cw anmecaaea naw ew = ee ee Semana mae f 
§ 13°17 1 1-511 { Longest control fieid | | 
{ eer ewes | ee ce wee ce | wee we ewes ewe ae eee ce mem wea momo womaoas | | 
i 18 oA { Records sorted tn ascending order j 
{ J ww cern wae | wow ew escent am we wma mas emo acoa = | 
4 | i O i Records sorted tn descending order i! 
(esses eas SaSrer" 4 ~— ao 2 sana msnnananmaonanannane aa 2 om an a @ oan | | 
!19- PL { All signs on are on teft of fietd a © 
{ Jp ww ee ceca jf eee wt eee emo een ws asaean -— = ws a an ne a | 
1 i Blank | ALL signs are on right of fielid | 
poeree=s2 [Seo SSeS So) 2 SSS Ses S ess Ss e= == SSS" ee Sees ese 
i 20 | Blank ! First input file witl not be oe 
4 ( i closed PURGE ! 
§ 5 cee recente ars aaa ow nae eeeee ae eas weet 
i it P 1 First input file will be closed rs. 
' - I | { PURGE i 
aaa gnc eae a a aac rt 
§ 21°25 ! Blank i Not used i | i 
{ ~eer enon jo er wee lw ee ee wa amwe aun aenmaanm ame ame “seen ene a wom i 
1 26 ( Blank ( Use standard collating sequence 4 
| | om ew we oe dell | —_ = aa = ow we ere eee ee ee ee ee nanan oowan a | 
i $s i Use alternate collating sequence i 
Joc w ocean | were wn cen [ew mas nam eco amon mamas aa asses = es= 4. 
{ 27 1 Blank | Not used | | I 
fewer ee ae | we wn anaae jonas anawan on ae em an a an S22 BB ean ama sa me @ econw| r 
1.28 | Blank § Keep control fields in output ! 
an i i records in tag along sort jobs £t 
i ! x { Drop control fields from output a | 
! ‘ f records in tag along sort jobs | ] 
Se Releteketetenedl | —<- = we = wea lene enema wasn woea amma soma aene | 
i 29-32 $1 178191 & Length of output records tn tag a | 
i 1 § atong sort jobs ft 


§ 35-39 1 0-99999 4 Additional storage size to execute 1! 
| | i i the sort» above 8K os 


Table 3.1 Summary of Header Speci fications 


Pere acre) AEDST TU RRL RR 
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Required and optionat entries for header-type specifications are 
discussed itn the subsection below. This discussion follows the 


COLCS) 


1-2 


13°17 


18 


19 


format described in the first paragraph of this section. 


HEADER“TYPE: FUNCTION AND DESCRIPTION 


Page Number: The first part of a_ five-digit page and 
line sequence nusber. If the sequence numbers given are 
in descending order» a warning will be issued. 


Line Nugaber: The second part of the five-~ -digit sequence 
number. If the sequence nuabers given are in descending 


orders a warning wilt be issued. 


Line Iype: Column 6 of the header Line contains an “H™ 
to identify this line. eo 


Iype of Job: The type of disk sort required is specified 
in these columns. SORTA means addrout C(TAGSORT) sort. 
SORTR means tag-atong (DISK SORT) sort. SORTRS means a 
Summary tag~along (DISK SORT) sort. | | 


Field Jotat: A description of the control field with the 
greatest tength.. The length» itn characters or bytes» 


must not exceed S1ii- It is determined by adding together 


the Lengths of the controt fields (N» O» or F tn column 


wy) for each type of record. When each type has been 


separately totaled» the Largest (Ctlongest) ts specified in 


these coluans. The number aust be right- justified in the 


coluan field provided on the coding form. 


Qrder: Indicates the sequential order» ascending or 


descending» in which the records are to be sorted. The 
entry is either A for ascending or D for descending. 


Signed Ejaetds: This cotumn determines whether fields 


wild be right or left signed. An L in this cotuan 


specifies all signs will be on the left of the fietds if 
the coluan is left blank all signs witt be on the right 
of the field. : 
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COLCS) 
20 


21-25 


26— 


28 


HEADER“TYPES FUNCTION AND DESCRIPTION 


File Close: This column is teft blank if the first input 
file is not to be closed purge. AP indicates the first. 
input file will be closed purge. | 


Blank: Not used for disk sort processing. 


Collating Sequence: This column is teft blank 1f the 
Standard EBCOIC collating sequence is desired. An Sin 
this coluan indicates that an aiternate coilating 


sequences which aust be specified through an ALTSEO 


statements» is to be used. 


If an alternate collating sequence is desired» colunn 8 
in the record type specifications must not contain a P or 
a U which would indicate that the fields described are 
packed or unpacked. | 


Tagralong Qutput: This column applies to tag-along 
output only. It indicates whether or not the program 
should drop controt fields from the sorted output 
records. The cotuan is left blank if the control fitetds 
should not be dropped. An X in this coluan indicates 


that the control fields should be dropped. 


Controt fields are normalty dropped if opposite control 


fieids or an alternate collating sequence are used. 
Furthermores users must specify these control fields 


twice (once as control fields and once as data fields) if 


CISC. 


opposite control fields or an alternate collating 
sequence are being used. Specifying the same field as a 


data fteld means that the program does not change the 


field since data fields are not involved in the sorting 
proce SSe a 


Jag Record Lengths: When a tagtalong sort is specified 
(SORTR or SORTRS)>» this field is used to specify the 
length of the output records written in the final sorted 
file. The length specified depends on whether the user 
has dropped control fields or not. If controt fields are 
dropped» tength includes only the data fields. If they 
are not» the length must be a sum of both control fields 


and data fields. In either case» the sum of the control 


and the data fields must not exceed the maximum record 
lengths of 8191 bytes. | 
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35-39 Sort Additional Menorcy: The number specified here will 
be added to 8K. | | 
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ty 


-B1800/B1700 SORT/UTIL 


COLUMN SUMMARY = RECORD SPECIFICATIONS 


ICOLUMNS! ENTRIES § EXPLANATION | : ' 


11-5 | 00000 - 1! Page and tine nuaber | ' 
{ 1 99999 | | 


1 6 i oi ( Include tine : a 


376 


COMPANY CONFIDENTIAL 


ITY 


1 1 oo 1! Omit Line | 1 


me [A 1 AND Line ' 


10 1 OR Line , | i 


8 !c. i Use both zone & digit char. portionsl 


1Zz ss. 1 Use only zone portion of icchar fitd |! 


! O | 1 Use only digit portion of characters! 


1 P | Signed packed decimal data 4 


iu ft Signed unpacked decimal data ‘ 


' 9-12 $$ 1°8191 ft Factor-1 - beginning position i 


i Blank Jf First Line of a set of I or O type J 


1 * { Comment tine i 


i | i cCbtlank if field pengen one) . { 


jose eee [anes a a J wee ew aw emaoaasaea <2 ob On en aD OD we a an ee an ae san wawam | 
{13-16 1 178191 ft Factor-1 - ending position | ( 
pees See | SSeS ee | a ee em a ee oF et an ae enee ne — = a ne -— a mm canna ao anm | 


1177-18 t EQ ' Factor-1 must = factor-2 ( 
; { NE Factor“1 must not = factor-2 i 
i LT Factor-1 must be < than factor-2 1 
1 GT Factor~1 must be > than factor=-2 1 
i Le Factor*l must be < = to factor-2 1 
1 
| 
i 


| GE {| Factor] must be > = to factor-2 


i 19 1c Factor72 is a constant 


' | iF | Factor-2 = another field in record J! 


1 20-23 11-8191 1! Factor-2 - beginning position _ 1 


| 24-27 | 1- 8191 { Factor-2 = ending position | ! 


§ 20°39 iCharacter! Factor-2 constant - any characters” 1 


| 40-72 iCharacter! Comments | | . ee 


Takhia 2F% 9 Cocemames anf BDarananznA Tuma nari ftiearinanne 
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COLCS) RECORD-TYPE: FUNCTION ANO DESCRIPTION 


Page Number: The first part of a five-digit page and 
Line sequence nuaber. If the sequence numbers given are 
tn descending orders a warning will be issued. | 


Line Number: The second part of the five-digit sequence 
number. If the sequence numbers given are in descending 
order» a warning will be issued. 


Line Iype: Column 6 must contain either I for include or 


0 for omit. The vatue I may be either include or 
include~all> depending on whether or not columns 7°39 
(record description) are blank. If record-type tines are 
used» the specifications must contain at least one 
Include or include atts otherwise» no records witl be 
sorted. | a 

Include: specifies which records are to be included in 


the sort, according to the particular records fields that 
are described in cotuamns 7-396 


Include-all: tells the sort program to sort all records 


that have not been described by any preceding include or 
omit tines. Only one include~atl can be used per job, 


and tt must be the tast record-type line for that job. 


Omit: identifies what records are not to be _ sorted. 
Omit lines are not required and are noraatly followed by 
an include-altl tine which tetils the program to sort att 
records not described by omit lines. 


sets: There are two types of sets: include sets and 
omit sets. An include set identifies one or more record 
types that should be inctuded in the sort. An omit set 


identifies one or more record types that should be. 


omitted from the sort. Sorting by sets presumes that all 
the records have at least one distinguishing 


characteristic in common. The rules for sorting by sets 
are as follows: | 


1. Alt inctude sets must end with a field-description — 
Line. | oo 


2- Omit sets never have field-description lines. 
3. Every omit set must be followed by an include set. 
he The last set must be an include set. 


NOTE: A time savings can be realized if Include 
statements can be organized tnto “groups". A "group” 
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consists of any consecutive Include statements that 
have tike displacements lengths type» have a relation 
of equal (£Q)» and refer to a constant for factor-2. 
They must not be joined by “"ANOD"s. 


Continuation of Comment: Column 7 indicates the line'ts 
relationship to the preceding tine for the specification 
of inciude and omit sets or indicates that this 1s a 
comment tine. Column 7 should contain one of the 
following entries: | 


Blank The column is left blank if it is the first of a 
set of include (1) or omit (0) Lines or is a 
single include or omit tine. 


A Stands for AND in relation to the previous inelude 
or omit tine. 7 


0 Stands for OR in relation to the previous include 
or omit lines i.e.» a different record type than 
the previous lines but the controt  fietd 
specifications are the same for both. 


* Identities this line as a comment line which does 
not affect the sort in any way. The line is. 
attowed purely for documentation. Comg@ents are 
printed onty if column 27 of the header tine 
contains a zero or a blank. | 


Interpretation: Specifies whether the data in the 
specified field is to be compared as character values or 
as numeric vatues during compare operations. When the 


field contains alphanumeric data» C» Z» or D must be 


speci fied. When the fietd contains signed numeric datas 


PP or UU must be specified. If an alternate collating 


sequence 15 used» a packed or unpacked field may not be 
used tn an include or omit record-type specification. 
Summaries of this information are presented in tables 3.3 


and 3.4. 
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CHER EKEKEKKEKEKAEKEEKKKHKKKKEKKKKK KEKE 


: | * Entry tt Compare Operation * 
| 3 * (col 8) «  * 
. . BEKKAEKEKAKKKEKEKKAEKHAKRKEKKKEKRKKKEKKKEKKEKEK KKK 
| | * s | | rt 
7 * Cc * Use both zone and digit * 
| * * portion of the characters * 
KREKKKKKKRKKKKEKKKKKEKEKKAkKKKKKkKKKKKEkKKkKK 
| | * N *« Unsigned packed numeric tk 
* * data | 7 - 
RHRKEAKKKKKKKKEKKKRKKKEKKKEAKEKRKKKkEkKKEKKEaRKkEKKKKK 
t : & * 
! * Z * Use antly the zone portion * 
| * * of the characters t 
RAEAKAKKEKKKKAKEKEKKKEEKERAKEKKAKKEKKEKKKkEKKKKKRKSK 

* * | * 

* D * Use anly digit portion * 

& * of the characters * 
RHEKKAEKKKEKKEKEKEKKKKKKKKAKKKKKKKKKKKKKKKkKKKEK 

, x fe 

* P * Numeric data is packed  } £* 

* * (see note below). * 
KRKKKKEKEKKAEKRKAEKKEKEKRKAKKRKKKKKKEEKKKRKKKKK KEK 

ot & * 

t U * Numeric data is unpacked * 

- * (see note below) * 


RHEE KKKAKREKEEKKKKKKKEKKKAKEKKKKKKEKAEKKKKKRKEK 


Table 3.3 Interpretation Entries 


Notes U and P are not atlowed when an alternate collating 
| sequence has been specified in conjunction with include 
or omit record=-type statements. 
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PeTTrrTTTrrT TT TTrie titi Tt tet tt te eee ete elie 2 dT oD 
*Format of * Entry & Definition — x Considerations * 
*Nu@eric Data * (col 8) « t * 
te HM REEMA MEKKEEKKKEKEKKEKEKEKEKEKKEKEKE 
* * * | 7 te | | se 
«Unsigned te D * Number does not * Absotute values of* 
* * * have a sign. Both * the nuabers are 
® * # the zone and digit* used. Att zone te 
* * * portions are * portions are * 
* te * stored. * stored as aFa ts 


ee eet ek tet ee TO TTT TT TE Rit kkk RRR Ran ik tk tk tit 


& * & & * 
* * * Packed: Number * * 
* * * always carries a * Sign control te 
* * * sign. Only the * (see note below) * 
* * P * digit portions are* * 
& * * stored. 3 & * 
® * * * x 
«Signed Kee Keke MME EKEKEKE KK KKK KEKKKEKKaKEKKKKKKKKKKKKHKKKE 
* * * * x 
* * * Unpacked: Number * 7 * 
* * * always carries a *« Sign control t 
* * * sign. Both the * (see note below) * 
* * U * zone and the digit« * 
* * * portions are * * 
* ~~ * stored. — | * * 
* t | * * & 
fe ee EE KEKE REE EEK KEEKEKE EEE EKEKKEEKEEKEKEKKEKEKEEKEKE 


Table 3.4 Format of Numeric Data 


1. The sign controts the coaparison. For examples -3 1s 
fess than zero and +5 is more than “6. 


2. Before comparing numeric data» disk sort converts any 


Leading blanks to zeroSse 
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— GOLCS2 RECORD-IYPE: FUNCTION AND DESCRIPTION 


9-16 #£=<~Eastor-1l Losation: Columns 9°12 identify where the 
| factor“1 field begins in the record. Coluans 13°16 — 
identify where it ends. 7 


Notes Factor-1 ts the data being compared in the 
record-type statements. fFactor-2 is the data Factor-1 is 
compared against. | | | 


The tength of the field cannot exceed the length of the 
record being sorted. For exampie» an 80-coluan record 
may have a maximum factor71 entry of 80. 

Entries are right-justified in columns 9-12 and 13°16 for 
beginning and ending cotunans>» respectively. When a 
length of one character its involved» columns 9-12 are 


left blank and the singte record position is entered in 
the field 13-16. | | | 


17-18 Relation: The relationship between factor-1 and factor=2 
must be specified and must be one of the standard 
relational operators listed betow. If an alternate 
collating sequence is used» both factor-1 and factor-2 
are modified before the comparison is made. | 
The relationship must be one of the following: 

EQ (Factor-1 aust be equal to factor-2.) 
NE (Factor-1 is not equal to factor-2.) 
LT (CFactor-1 is less than factor-2.) 

GT (Factor-1 is greater than factor-2.) 


LE (Factor-1 is less than or equal to factor-2.) 


GE (factor-1 is greater than or equal to factor-2.) 


19 fEField or Constant: Identifies whether factor-25 the 
7 field factor-1i is to be compared to» is a constant or a 
field. When aC is entereds cotuans 20°39 are used to 


define the constant. When an F is entered» cotuans 20-27 
are used to identify the location of the factor<-2 fietd 
within the record. | 


rbd EE CEES ST errs pease teeescee es os 


COL(S) 


20-27 


20-39 


40°72 
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RECORD=TYPES FUNCTION AND DESCRIPTION 


Eactor-2 Eield: Factor-2 must be the same length as 
factor-1 and must be located within the same record. 
Similar to factor-1 declarations» the starting position 
of the field is declared (right-justified) in columns 


— 20-23 and the ending position. is dectared 


(right-justified) in columns 24-27. One-character fields 
are described with an entry in the ending-column hatf of 
the field only. : 


Eactor"2 Constant: When factor-2 is a constants the 
constant is entered in coluans 20739. Note that the. 
length of the constant must be the same as the Length of 
factor-1» for a valid comparison. The constant may be 
declared as any vatid EBCDIC characters» or string of 
characters. Alphabetic or atlphanumertc constants are 
left-justified within the fietd. 


Numeric constants must be right-justifited within the 
field tength specified in factor-1 (Cwithin twice the 
field length if factor-1 is a # packed number)» with 
leading zeros or blanks. For example» a S=position 
factor~1 that is being compared to the numeric constant 


"123" must be dectared as *00123" or " 123" jstnce the 


two fields must be the same length. In this example, 
"123" is right-justified in a 5-position field. 


Signed constants: If factor-1 is a packed number » the 
last digit in the constant must be its sign (+ or -). If 
factor-1 is an unpacked negative number, the tast 
character in the constant must be one that indicates both 
the numeric value of the tast digit and the negative sign 
for the entire constant. See Table 3.4.5. 


Comments: These columns are available for any comesents 
that the user wishes to make. Comments have no effect on 
the prograam*s operation. 
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i Coding Negative Unpacked Constants 1 
| ee ee 88 8 we 8 ew ae an aen B ames anew Bean amano naan | 
i If last digit 1 Character t Hexadecimal 1 
f= tin constant is t . used ff Equivatent i 
1 | | 
J ower es cee wesw wewecas losses ance am j ssa ancawaanmanwawn | 


{ 0 t 5 4 2002 : 


s ‘ 


L ae 1 J i aD1a f 


‘ 2 i K i  ap2a ' 


L 3 i L { a03a f 


i 4 i M ol a04a ( 


i 5 i N { a05@ t 


‘ 6 { 0 { aD60 { 


| 7 p av7a 


{ 8 j Q i 2082 t 


4 a , R ' anga 


2 


Table 3405 Coding Negative Unpacked Constants 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 


ee ee ee ee ee ee ee ee ee eee ee 
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COLUMN SUMMARY = EXELD SPECIFICATIONS 


jee ewan a | sw wow aman e a | > a GO OD ON OD ED oF aD ae oS Oe Dm em aswaewwananoame | 
ICOLUMNS!I CONTENTS 1 EXPLANATION | | ! 
Jor eawoe j cannes nem ae | ede Maka tk hk hk ee ee ee 2. oe 2 cnanwm naman a am om f 


11-5 & 00002 - 1 Page and line number | 1 


\ 1 99999 ' | t 


1 6 {Ff | t Field specification tine { 


1 7 i oN 1 Noraal control fietd | ] 


1 oO | Gpposite control field dt 


if i Forced control field | ae | 


J ecw wee we qeea | ee wwecwweawecwna es -—- - «2 saa wo wan onwasae | 


'o | Data field —_ 


is 1 Summary data field -* &, a 


1 * i Comment line | | | { 


8 i P § Signed packed decimal data a 


iu . i Signed unpacked decimal data i 


ic ! Field uses zone & digit chars t .| 


1Z : ! Uses zone portion of i-char fieldl 


1D { Uses digit portion of characters ! 


| i ov i Forces data character into field |! 
fcc ence a j sSnuw awn monan ae law aw nana naa ee a nannw mae @ enw eocnacoanae | 
1 9-12 1 178191 | Starting position of field i 
1 i § Cblank if field length one) — i 


§ 13°16 1 17-8191 1 End position of field in record 1 


417 1Any nonblankti Forced field conditionat char. ! 


118 lAny nonblank! Forced fietd substitute char 1 


{ es eeeee J ww ce ew ewoenaa | a Ob me OD Om Se OD GP a Um aS OD OF an Seana moma mam | 
#19 i Blank i Forced fiteid not a continuation i 
bo | of the preceding line _ i 


4 1 Not blank 1 Forced field continuation ; 


1 20-22 1 1°999 i Summary overflow field tength i 


i 23°39 1 Not used { Not used t 
| Cateieieeteeal | — ae om an oe om an am em an om fl ae am oe om oe am oe om on ee om mn a a ae = <2 on a — on we a a en oe a an oe en an ae f 


§ 40°72 JWAny text ' Comments - characters { 


q 2 <n a a ce an ae 8 See ergs 2D OS ON MP OD OD OD SR ND ON HD ON OE GN SD aD GY GD OF we aD a aD ae am oe ae ae a am ae aw f 


Tahia £5 Gummarv of Fieid Nascrintion Snecifications 


COMPANY CONFIDENTIAL 
| -B1800/81700 SORT/UTILITY 
SANTA BARBARA PLANT P.S. 2222 2562 (A) 
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coLcs) ELELO-TYPE: EUNCTION AND DESCRIPTION 


Output records from a disk sort are formatted (Carranged) 
according to the instructions of the. sort's field-description 
specifications. $$ This subsection defines the proper syntax for 


those fietds. 


i-2 Page Nugber: The first part of a five-digit page and 
line sequence nunber. If the sequence numbers given are 
in descending orders a warning will be issued. 


3°5 Line Nugber: The second part of the fiverdigit sequence 
number. If the sequence numbers given are in pesceneing 
order» a warning will be issued. 


6 Line Type: Column 6 of the field line contains a 
preprinted F to identify this Line.  Addrout sorts. 
CSORTA) use field lines describing control specifications 
only. The field Lines used by tagz-along sorts CSORTR) 
and summary tag-atong sorts (CSORTRS) may be either 
control fields Cused to sort the records) or actuat data 
fields. In addittons field tines for summary tag-along 
sorts describe the fields that the program is expected to. 
Summarize. 


a Field Iype or Comments: Entries tine this column are 
chosen from the table below: 
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RAKE EERE EKEREKREREKRKEAEKKEKKKKEKKKKKKKKKKKKKKKKKKKKKKKE 
* Entry * Specifies: * 
* (col 7) * a 
RHEAEKEAEKKAKKKAEKKAERKKAKKKEKKKKKKARKEKKKEKKKKRKEKEKKKKRKEKRKEAEKKEKREKEKEKKKAaKEK EK 
* * * 
* * This ts a data field. It is used for tag-along * 
t D * CSORTR» SORTS) sorts only. If aD entry is used * 
® * during an addrout sorts it is treated as a * 
* * comment line. - ; is 
* x : a 
CAREER EE EEE EEE EERE EERE EEE EERE ERE REE EE ERR EE EEE EEE EER EEE 
* * * 
* * A normal controt field. Sort this field so that *« 
* N « data from the field is in the sequence specified t 
* * in coluan 18 of the header line. — t 
& * ou te 
ee ee ee a ee re eer ere rere ey re eee eee ee ee 
*® * ; * 
* * This is an opposite control fietd. Sort this * 
*« QO * field so that the data from the field is in the * 
& | * sequence opposite that specified in coluan 18 * 
ts * of the header (Line. * 
x * 
HHH MH HI KEKE ERE KKK RE MEKKKEEKEKEKEEEKEKKKKKEKKKSK 
* _ * | _ eS t 
* * This is a forced control field which specifies * 
* F * that the control fietd should be modified * 
* | * according to the entries in cotumns 97-19. * 
* * & 
CREE EERE REE ERE EERE EERE EERE EERE REE EERE EERE EER ERR 
te | * | | : « 
* i) « This 1s a sugmary data fietd. It is used for * 
* summary tag~along sorts (SORTRS) only. If anS * 
* * 1S entered during an addrout sorts» the line is t 
& * treated tike a comment tine. If an S is entered * 
al * during a tag~along sorts the fields are treated * 
te * as normal data fields. 7 : - | f 
& * * 
He te tek RIK KEKE ERK KEE KKM EK KEREKKKKKEKREKKEKKKAEKKKAE 
& * x 
e«  * * This is a comment line. | . te 
* * & 
* 


RE REE REE EK REE EER ERE EE EE EERE ER EERE EEREEEE 


Table 326 Interpretation Entries 
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FIELD-IYPE: FUNCIION AND DESCRIPIION 


Data Fields: (0 in Column 7). Data fields apply to 
tagzalong (SORTR» SORTRS) sorts only. They are fields 
that users wish to have tncluded in the output records. 
Control field lines must be declared before data fields 


within include sets. 


When a file has more than one type of records the 
following conditions apply: | | 


* The number of data fields do not have to be the’ same 


for all record types. 


* The total lengths of atl the data fields do not have 

| to be the same for all record types. Disk sort 
places blanks to the right of shorter data fields so 
that all total tengths are equal. 


Controt Fields: (N» O» or F in column 7). These fields 
determine the sorted sequence of the output file. They 
apply to all three types of sortss SORTR» SORTRS» SORTA. 


Opposite Controt Fields: indicates that the control 
field is to be sorted in opposite order from that 
specified in the header fine. For examples if the header 
line has established ascending order as the order for 
this field» a0 specifies descending for this control 
field. | 


If the file contains different record types» att of which 
have an opposite control field in the same record 


position» the column 8 entry must be one of the 
fotlowing: alt Ds» all Cs» all Zs» or any combination of 
Cs and Zs. Any other combinations produce unpredictable 
results. | 


-- Packed or Unpacked Controt Fields: Controt fields are 


changed white buitding the work record to allow proper 


sorting of signed fields. Therefore» control § fieid 
information must be dropped by entering an X in coluan 28 
of the header iine. If users wish to aatitntain the 


original control field data in the output records they 
must repeat the control information as a data field. 


Forced Control Fretds: CF in column 7). © These fietds 
are implemented itn three access Conditionals Force~all>» 
and Unconditional. | 


Sedee nape res eget oe 
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cOL¢s) EIELD-IYPE: £UNCTION AND DESCRIPTION 


Forced controt fields affect the work and output records 
only. The proper syntax for these modes is found in the 
discussion of coluans 17°19 below» and in Appendix Bs 
FORCED“FIELD SORTING PROCEDURES. 


Forced Control Fields are defined according to the 
— following conventions: 


* Qnly one character may be contained in a_ forced 
control field. : be 


* The force may be either conditional or unconditional. 


* A force-att tine «aust be preceded by a conditional 
| force line. | 


Khen a file has more than one type of records: 


oe The number of control fietds does not have to be the 
same for alt record types... 


* The total lengths of the control fields do not have. 
to be the same for alt record types. 


When records with duplicate controt fields (records 
with ait the controt fields equal) are sorted» the 
order in which they are output cannot be guaranteed 
to be the same as the order in which they appear in 
the input file» i.e.» the sort ts not stable. | 


Summary Data Fields: An S in cotumn 7 defines a summary 
data field. Summary data fields may be defined for atl 
three types of sorts» but the fields are added together 


Csummarized) only in summary sorts. In tag-atong sorts 
CSORTRI» summary fietds are treated as normal data 
fields. — In addrout sorts (SORTA)» summary fields are 


treated as comments. 


In a summary sorts» the summary data fields in the work 
and output records for individual record types must 
always be tn the same position. The fields do not have 
to be in the same position in the input records. 


The first include set that contains summary 
specifications defines the summary format for att 
included records of any sets. It is recommended that allt 


include sets contain summary specifications if one of 
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cOL(S) FIELD-IYPE: EUNCIION AND DESCRIPTION 


them does. If an include set does not contain summary 
specifications» the data specification should align the 


data for summarization. 


loterpretation: Specifies whether the data in the 


‘specified field is to be compared as character values or 


as hexadecimal vatues during compare operations. When 
the field contains alphanumeric data» C» Z» or D must be 
speci fied. When the field contains signed numeric data» 
P or U must be specified. If an alternate collating 
sequence is used» a packed or unpacked factor-l may not 
be used. When the field contains a V» a data character 
is forced into the data _ fietd. A suemary of this 
information is presented in table 3.4. 
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KR KKK KEKHEEKRKKKAKKHAKKKKKKKEKKKKKKKK 


* Entry * Compare Operation & 
* (col 8) «. * 
RKEEKKAK Kk ke KkKEKKKKKKkKkkKkaeKKRKEKKKKKKKKKKAKKKKKKEK 
~ *& , ot 
* C * Use both zone and digit te 
* * portions of the characters * 
RKEKEKAKKKKEKKKEKEKKKAEKKEKEAEKEKKEKKKEKKKKKEKKKEK 
* * «x 
tt N * Unsigned packed numeric t 
* * data x 
RREEKKEKKEKREEKKKAAKEKKKKEKKKKKRKKKKKKKKAKKKE 
* *& * 
* Z * Use only the zone portions *« 
* * of the characters | t 
KRRKKKKEKKKKKEKEKKKEKEKEKAKKKKKKKKKKKkKKkKKKKKE 
*« * * 
* D * Use only digit portions 
~ « of the characters * 
KRKKARRKEKEKKEKKAEKKERAKAEKKRKKEKKKEKEKEKKKEKEEKKKE 
* * 3 
P * Numeric data is packed of 
* | * (see note below). 
- RRKRKEKKEKKEKERAKEKKKKKKKKKKKKKEKKEKKKKkKKK 
* , ae * 
* U * Numeric data is unpacked & 
* * (see note below). * 
KKKKAKKEKEKKEKAKKAEEEKEKEKRAKKKKKKKEKKERKKKRKKR 
_ * * * 
* y - « Force one data character * 
ik * jnto the data fietd. 


BUECKER EKHEKKEEEKEKKKEAEKEEEKEKEKKKKKEKKKEK 


Table 3.7 Interpretation Entries 


Note: U and P are not attlowed when an alternate collating 
sequence has been specified (S in column 26 of the header 
record). 
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Table 3e8 shows possible combinations of cotumns 7 and 8. 


KAKKEAHKEKAKRAKEKEKKKEKKEEK 


* Col. 7 * Col. 8 x 


KRKKKKKEKKEKKEKEEKKKKKKEK 


* N or 0 * C * 
® * Z * 
* * D * 
* * P * 
_s ft U * 
KKkkKKEKKKKKKKKEKKEKKKEKAKEK 
* F * c(i) * 
* * Zi) * 
* * O(i) * 
wkkkkkkkkkkkkkkkkkkkkkee 
& D & C & 
tt * 7 * 
* * D * 
* * Pr * 
* * U * 
* te | t 
kkkkkkk&k&kekkkkk&kkkkki&kt 
* S & C * 
* * Z * 
* * D * 
* * P *& 
* & U * 
* * y & 


kaek&kkkkkakkkkkekekkk&kkkkkKk 


(1) For an unconditional force and a force~ail line» cotuan 8 
must contain a Ce . 


| Table 3.8. Possible Combinations of Columns 778. 


3-22 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B18909/B817090 SORT/UTILITY 
SANTA BARBARA PLANT P.e.Se 2222 2562 (A) 


COLCS) 


9-16 


17 


18 


FIELO“TYPES FUNCTION AND DESCRIPILON 


Field Location: Identifies the input record positions 


that contain the record fields. Columns 9°12 (Cfrom) 


specify the starting position of a field; coduans 13-16 


the ending position of the field. The order in which the 
fields are described determines the precedence of the 
control fietds and the format of the output record. 


Entries must be right-justified»s ending in columns 12 and 
16 #£=respectively. One-character fields require a 
rightcjustified entry in columns 13°16 only. 


Conditionally Forced Character: An entry in this coluan 
1s only required when a conditional force is desired (see 
column 7 or Appendix 6B for further discussion of 
Forced-Field Sorting procedures). The entry tells the 
disk sort program which character in the controt field is 
to be replaced by the character in coluan 18. 


If a control field contains one of several characters 
that are to te replaced with separate forced characters» 


an entry itn cotuan 19 must be contained in all the 
forced-fielid lines except the first. see column 19 for 
instructtonse : | 


Forced Character: This coluan contains the forced 
character when aie forced controt-field sort has been 
speci fied», otherwise it is blank. The character either 
replaces the control field character specified tin cotuan 
if or it adds a new character to the controt field for 
sorted output record(s) onty. Note that att the | 
restrictions for a vatid forced-control-field sort (see 
discussion on colugn 7) apply to this entry. 


Note: See Appendix 86 for “further discussion on 


 Forced-Field Sorting Procedures. 


19 


Forced Field: Multiple Replacements: If a controt field 


an an input record may contain any one of several 


characters and forced-character replacements for more 
than one character are desitred» a separate line is used 
to define each possibte character and the _ forced 
character with which it ts to be reptaced. § Note that 
column 19 must be blank for the first field statement in 
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20-22 


an include set... 


Coding: Multiple Replacement 
le Define the control field in coluans 13716. 


2e Enter the first character to te replaced in cotumn 
17. , 


3. Enter the character which replaces it in columns 18. 


4. Enter the next character to be replaced in coluan 17 
of the next line. 


(5. Enter the character which replaces it in column 18 of 


the same line. 


6. Enter any character except blank €2402) in coluan 19 
of the same line. This specification informs disk 
sort that the line refers to the same controt field 
in the work record as the preceding line. 


“fe Repeat steps 4» 5» and 6 for any other characters to 


be replaced. 


Notes if column 19 were teft blank» each Line would 
define a new position in the work and output records. — 


Notes if the input records are being sorted in 
ascending order (CA in column 18 of the header tine)» 
a aFFa is placed into the work record before any 


characters are forced. If descending order» a 2002 
is placed into the work record before any characters 
are forced. Therefore» if a force character is not 


found» the hexadecimal characters (aFF@ or 2902) are 
left unchanged in the work record. 


Qverfiow Field Length Entry: These columgnns are _ used 
only by a Summary Tag~Alonge . SORTRS» sort to eliminate 
the possibility of an overflow condition by increasing 
the Length of the summary data field to attow for any. 
anticipated overflow. ~ 3 | 


The overflow field length entry should reflect the sum of | 
the summary data field tlength and _ the anticipated 


overflow length. The entry must be right-justified in 
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23°29 


40-72 


coluan 22 and cannot exceed the maximum field length. 
Columns 20°22 are ignored by a FSZ and an FSV since these 
fields can be only one byte long. 


Blank: These colugns are not used = and should be teft 
blank. | | 


Comaents: These columns are available for any comments 
that the user wishes to make. Comments have no effect on 
the prograa‘’s operation. | : 


Be 
oes 
Sa a ee e 
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MESSAGES 


This section covers error and warning messages generated by 
SORT/UTILITY. Error messages wilt hait further processing of 
SORT/UTILITYS warning messages are informational only. | 


Both error and warning messages wilt be printed on SORT/UTILITY's 

output (LINE) file. If the NOPRINT option has been specified» a 
Listing will be generated onty if there are errors or warnings. 

If program switch 1 is set to 1 (SWi=1)» any occurring errors or 
warnings witt be printed to an ERROR.LINE files atong with the 
assoctated text. | | | 


Error and warning messages associated with a specific tine will 
immediately foltow that Line. Messages associated with a record 
types such as “INCLUDE/DELETE MISSING FROM PREVIOUS RECORD TYPE", 
foltow that record type description. The remaining error or 
warning messages refer to all the input specifications» such as 
the warning “DIFFERENT CONTROL FIELD LENGTHS: ACTUAL <INT1> 
SPECIFIED <INT2>”. These messages wilt occur at the end of the 
SORT/UTILITY listing. | a 


ERROR MESSAGES 


"A DISPLACEMENT EXCEEDS MAX INPUT RECORD SIZE OF <INT1I> BYTES* 


A displacement specified in a fixed or free format statement 


is larger than the maximum record size of the specified input 


files (denoted here by <INTI>). 


"BLOCKING IS NOT AN EVEN MULTIPLE™ 
In this free format FILE statement» the number of records per 


area specified for the current file is not a eureren’ of the 
number of records per block speci fied. 


"CONFLICTING BLOCKING" 


In this free format FILE statement» the records per area 


specified is greater than or equal to the specified records 
per bdtlock. | 
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"CONFLICTING LENGTHS" 


In the current fixed format INCLUDE statement» the field 
length described in cotumns 9°16 conflicts with the field 
Length described in columns 20-27. 


"CONFLICTING SPECIFICATIONS" 


Header statements or free format FILE statements contain one 
of the following errors: 
| - conflicting types of sorts have been specifieds such as 
TAGSORT and SUMMARIZE 
- DROP CONTROL has been specified with a TAGSORT 
- DISK DEFAULT has been specified in the FILE statement 
along with a records per area part 


"CONTROL FIELD LENGTH IS GREATER THAN 511 BYTES” 


The maximum key length of 511 bytes has been exceeded in. sone. 
of the following ways: 
- The sum of the control fields of the previous record. joe: 
exceeds 511 bytes | 
- The number indicated as the maximum key size in the fixed 
format header cards columns 13°17» or the free format CONTROL 
statement is greater than 511 


"CONTROL FIELDS MUST PRECEDE DATA™ 


Control fields have been found following data fields within 
the current record type. ; 


"DATA NAME INVALID IN THIS CONTEXT" 


A word composed of alphabetic characters was found outside of 
statement context. It is not a reserved word. This error 
wilt occur only once until aeoreserved word is founds 
signifying statement context is to be resumed. 


"DIRECTION OF REMAPPED KEY IS NOT THE SAME™ 


In the current free format FORCEKEY statement» the directions 
ascending or descending» is not the same as that of the key 
or FORCEKEY at cemaps. | an 
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"DISK DEFAULT ONLY™ | 
Gnly the attributes of a disk file can be defaulted in a free 


format FILE statement. 


"EXTRA FILE IN OR OUT" 


In the current free format FILE statement» more than 16 input 


files or one output file have been specified. 


"EXTRA LEFT PARENTHESIS" 


In the current free format FILE statement» an extra left 
parenthesis has been found. | | 
"FORCEKEY REMAPS MUST FOLLOW KEY OR FORCEKEY™ 
Only a KEY CFM or FO) or FORCEKEY (FF) field can be remapped 
Canything but blank in column 19) by another FORCEKEY field. 
"INCLUDE/DELETE MISSING FROM PREVIOUS RECORD TYPE™ 
Previous data or controt fields were described before the 


current INCLUDE or DELETE statement» and they were not 
preceeded by an INCLUDE or DELETE statement. 7 


INCLUDE MUST FOLLOW DELETE" 


The tlast DELETE statement of a record type must be followed 
by an INCLUDE statement. _ 4 


“INCORRECT RECORD SIZE". 


In the free format FILE statement» the record size specified 


for the current file is described to be zero or greater than 
Bi9l bytes. ' 
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"INCORRECT VARIABLE PART™ 


The free format FILE statement had one of the following 
errors: 
© FILE statement is incoaplete 
- the parentheses expected are missing 
- something other than a number has been specified for the 
maximum block size 


“INPUT RECORD IS OEFINED TO BE GREATER THAN 8191 BYTES” 


The displacements» lengths» or displacements ptus lengths 
given in the record and field type statements describe input 
record positions greater than 8191 Eyres 


"INVALID CARO TYPE™ 


Column 6 of the current fixed format card does not contain an 
"H™» "I" "OO" OR "F*» nor is this an “ALTSEQ" card. 


"INVALID COLLATE STATEMENT™ 


Processing of the current free format COLLATE statement has 
been terminated due to one of the fotlowing errors: 
= more than 256 items have been specified to be coilated 
- could not find ending quote or da-sign of a literal 
- delimiter other than a quote or a-sign found 
- missing left parenthesis 


“INVALIO CONSTANT" 


The numeric constant of the current free format statement 
contains non-numeric integers. | 7 


“INVALID CONTROL STATEMENT® 


No number has been given to represent the maxiauam sum of the 
control fields. 
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"INVALID DATA STATEMENT™ | | 


Processing of the current free format DATA statement has been 
terainated due to one of the following errors: 
- the statement is incomplete» length or displacement missing 
- the disptacement or length given is zero 


"INVALID DATA TYPE” 


Coluan 8 of the current fixed format record or fteld type 
statement does not contain a “Z"» "D%» "P™» "C™» “U" or “V"%. 


PINVALIO DEVICE” 


The free format FILE statement has one of the foltowing 
errors: | 3 
= device type is either missing or not equal to one of the 
following: DISK» PACK» CARD» CARDS» TAPE or PRINTER 
- the current input file's device type has been specified 
as PRINTER | 


"INVALID DISPLACEMENT" 


A displacement was expected»  but— one of the following 
conditions was found: | 
= the itew@ is non=numeric 
- the item is zero 
- in fixed format only: | 
- an ending displacement is blank 
=- an ending displacement is of smaller value than a 
starting displacement 


"INVALID DROP CONTROL STATEMENT" 


The expected word “"“CONTROL* is missing. 


"INVALID FIELD TYPE" 


In the current fixed format Fiela statement» column 7 does 
not contain a "0"%» "N%» "F*%» "D" or “S". , 
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INVALID FILE NAME" 


The file name in the current free format File statement was 
invalid for one of the following reasons: 
- file name found does not follow standard B1800/B1700 file 
naming conventions 
- left and right parentheses must be in quotes 


"INVALID FILE STATEMENT" 


Processing of the FILE statement has been terminated due to 
its incompleteness (see syntax for explanation of 
non-opttonal parameters). | 


"INVALID FIXED STATEMENT" 


A non-numeric token was found following the word "FIXED". 
Onty the word "FIXED" or "FIXED" followed by a number should 
be present on this record. 


"INVALID FORCEDATA STATEMENT™ 


Processing of the current free format FORCEDATA statement has 
been terminated due to one of the following reasons: 

- expected teft parenthesis is missing 

- constant not found | 


"INVALIO FORCEKEY STATEMENT" 


Processing of the current free format FORCEKEY statement has 
been terminated due to one of the following reasons: 

- expected left parenthesis is missing 

- displacement given is zero 

- displacement is given but not foltowed by two constants 
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"INVALID INCLUDE/DELETE STATEMENT" 


Processing of the current free format INCLUDE/DELETE 
statement has been terminated due to one of the following 
reasons: | | 
- an "ANDO" or "OR" was specified but no further specifications 
foitlowed 
- expected left parenthesis is missing 
« two disolacements» or one displacement and one delimited 
constant are missing 
- non-numeric token found when expected numeric displacement 
- "DELETE" is specified fottowed by no further specificattons 
- dispiacement or Length given is zero : 


"INVALID KEY STATEMENT® 


Processing of the current free format KEY statement has been 
terainated due to one of the following reasons: 

- expected left parenthesis 15 missing 

- displacement or tength given is zero 


© "INVALID LENGTH" 
In a free format KEY» DATA or SUMMARYDATA statements a length 
was expected where a non=numeric token was found. 


# 

a ETL am ct Nr ee a 
tar 

Fe , 
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"INVALID LITERAL” 


If the error message is referring to a free format COLLATE 
Statements» then the error is due to one of the following: 

- duplicate specification of cotlated characters 

- hex pair of integers required to specify a character» or 

position was not found 

- dash or left parenthesis followed BY another dash or left 

parenthesis | 

- dash» left parenthesis» or valid hexadecimal character 
expected but not found 

- beginning value of range is equal to ending vatue 


If ithe error a@essage is referring to a free format 
INCLUDE/DELETE statement, then the error is due to the 
following: 
= ending deliaiter of constant not found on current record 


If the error message is referring to a free format FORCEKEY» 
FORCEDATA or OVERFLOW statements» the error is due to one of 
the following: | 

- delimiter other than quote or. a-sign found 

- ending delimiter of constant not found on current record 

- constant specified describes more than one byte of data 


"INVALID MEMORY STATEMENT™ 
No number or a number less than 8000 was given following the 
word “MEMORY” or "ME®,. : 

"INVALID OVERFLOW STATEMENT" 

Processing of the current free format OVERFLOW statement has 


been terminated. No token or a token other than quote or 
a-sign was found following a left parenthesis. 


"INVALID PARITY PART™ 


Processing of the FILE statement has been terminated. No 
token or a token other than "E> "EVEN™s "0" or "O00" was 
found LoTToeNns a Left parenthesis. | | 


“INVALID RECORDS PER BLOCK" 


Processing of the FILE statement has been terminated. The 
number of records per block was specified as zero. | 
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"INVALID RELATION*™ 


In the current fixed format record type statements cotumns 
17-18 do not contain “EQ"%» “"NE“» “LIT%>» "GT"%» "LE* OR “GE". 


"INVALID RELATION FOR ZONE® 


In the current fixed format Record type statement» column 8 

contains a "Z"»s indicating a zone type fietds  #$£therefore>r 

columns 17°18 may only contain "EQ" or “NE"» indicating 
“equal to™ or “not equal to” relations. | 


"INVALIO SUMMARYDATA STATEMENT™ 


Processing of the current SUMMARYDATA statement has been 
terminated due to one of the following reasons: 

- expected teft parenthesis 1s missing 

- displacement or tength are not given 

- displacement or Length are zero 


"INVALID TYPE COMBINATION” 


In the current fixed format Field Type statement one of the 


following errors occur: 
- column 7 contains “N® or "o* and cotumn 8 contains a "Vv" 


- column 7 contains an “F™“ and column 8 contains “P"™» "UU" or "VV" 


“INVALID ZIP STATEMENT™ 


Processing of the ZIP statement has been terminated due _ to 
one of the following reasons: 

- delimiting beginning quote not found 

= message 1s tonger than 256 characters 


“MINIMUM TAPE RECORD SIZE ALLOWABLE IS 8 BYTES™ 


In the free format FILE statement» the hardware type has been 
specified as tape and the specified nears size 1s toss than 
8 . oy tess 


USES oegsMles ek TREE laeeea AGAR COPE ere ee 
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"MISSING ENDING QUOTE* 


Ending quote was not found before the end of the current 
record. In the case of a ZIP statements an ending quote was 
not found before the end of the CARDS file. 


“MISSING LEFT PARENTHESIS® 


In the current free format Record or Fietd type statements a 
left parenthesis was expected and not found. 


“MISSING RECORD SIZE” 


In the free format FILE statement» a numeric token 
representing record size was expected following hardware type 
but not found. Record size must be given unless DISK DEFAULT 
is specified. | 


"MISSING RECORDS PER AREA PART" 


‘In the free format FILE statement >» DISK or PACK was specified 
as the hardware type followed by a teft parenthesis» 
indicating a records per area and optionally a number of 
areas specification to follow. Either no token or a 
non-numeric token was found. : 


"MISSING RIGHT PARENTHESIS" 
A right parenthesis was expected to terminate the previous 
statement. No tokens were found and all other specifications 
for this statement were optional. | 

"MULTIPLE FILES ON DISK ONLY* 

In the free format FILE statement» MULTI was specified with 
other than a DISK or PACK hardware type. Multicpack files 
are onty defined for DISK or PACK... 

"MUST HAVE CONTROL FIELDS” | 

No valid KEY C"FN" or "FO" Col. 6-7) or FORCEKEY C"FF" Cot. 


6-7) type statements have been found in the previous record 
type. . 
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"MUST HAVE DATA FIELDS WHEN OROPPING CONTROL™ 


“NO 


"NO 


*NO 


"NO 


*NO 


DROP CONTROL has been specified in the header cards. No 
valid DATA or FORCEDATA ("D" Col. 7) +or SUMMARYDATA C*S*® 


Col. 7) fields have been defined in the previous record 
type. 
CLOSE KELEASE OF OISK FILES" 


In the free format FILE statement» RELEASE was specified with 
a hardware type of DISK or PACK. Close retease is only 
defined for non-disk files. 


INPUT FILE SPECIFIED" 


The FPB values for hardware type and file name have not been 


altered» with a FILE statement or file equates» froa@ their 


initial vatues of SPO and nuil» respectively» in any of the 


input file FPB*S. 


INPUT SPECIFICATIONS” 


No valid statements were found in the CARDS file. 


MORE HEADER CARDS ALLOWED" 


All header type statements must occur before all record or 
field type statements in the CARDS file. | 


NAME™ 


The word FILE was specified in the COLLATE statement 


indicating a fite woutd fotlow. No tokens or a teft 


parenthesis were founds» however. 
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“NOT A NUMBER” 


If the error refers to a free format statement: 
=" A numeric token was expected following the words ~CONTROES 
“MEMORY” or “ME™ but none was found. | 


If the error refers to a fixed (orwat statement: 
- A numeric token was expected but not found in the header 
card in columns 13°17» indicating maximua control key lengths 
or columns 29°32» tndicating maximum output record tength. 


"NOT HEXADECIMAL VALUE" 


A hexadecimal number was expecteds delimited by a-signs. 
Integers found were other than "012345678 9ABCDEF™. 


“NUMBER IS TOO BIG" | 


The number’ found is Larger than expected. The Limits used 
are as follows: 
- maximum number of areas allowable is 105 
- all numbers must be less than 6 integers longs ereevt 
constants 


“ONE FIXED HEADER CARD" 


More than one fixed header cards "H*® in column 6» has been 
found. _ 


"OUTPUT RECORD IS DEFINEO TO BE GREATER THAN 8191 BYTES" 


The maximum output record tength of 8191 bytes has been 
exceeded in one of the following ways: | 
- the number indicated as the maximum output record size 
in the fixed format header card» column 29-32» is greater 
| than 8191 bytes 
- the sum of the data and control field type cards (data 
— onty if drop controt has been specified) of the previous 
record type exceeds 8191 bytes 


"OVERFLOW INDICATORS ARE NOT THE SAME" 
In a summary sort» cnly one OVERFLOW indicator may be 


described. It must be the same (same output record positions | 
sage literals) every time it is defined. | | 
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“PREVIOUS INCLUDE ALL ENCOUNTERED” 

Once an INCLUDE ALL has been described» no other INCLUDE or 

DELETE statements (record type statements) are allowable. 
WPPURGE INPUT FILES ONLY" 

PURGE has been specified as the output file's close type. 

Close purge may only be performed on an input file. _ 
"RELEASE ON QUTPUT ONLY” 
RELEASE has been specified as an input file'’s close type. 
Close release may only be performed on the output file. 
"SIGN NOT ALLOWED" 
The constant delimited by nusber signs (f)» or specified in 
fixed foraat contains the sign symbol» + or ~» but has a type 
of ALPHA» ZONE» DIGIT» UA» Cs» Z or D Cunsigned type). 
"SPECIFIED TWICE” 

The onty type of statements that may be specified more than 
once are: FIXED» INCLUDE» DELETE» KEY» FORCEKEY> DATA» 
FORCEDATA» SUMMARYDATA and OVERFLOK. | : 

"TAGSORT INVALID FOR MULTIPLE FILE INPUT™ 
The word "“TAGSORT*» in free format» or “SORTA">s in fixed 
formats has been specified with more than one input file. 
Relative record pointers would not be meaningful. | 
"UNLABELED DISK FILE® 


No file name was givens either with a file statement or file 
equates to the input disk file being defined. 
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WARNING MESSAGES 


"ALTERNATE COLLATING SEQUENCE ASSUMED” 


In the fixed format header cards column 26 does not contain 
an ™S" or a blank. An alternate cotlating sequence wilt be 


expected. 


“CHARACTER CONSTANT LENGTH TRUNCATED TO 20 CHARACTERS" 


In the current fixed format INCLUDE/DELETE statement» the 
length specified in columns 9°16 is greater than 20 bytes and 
a constant has been specified. The tength will be truncated 
to 29 bytes. | 


"CONFLICTING OVERFLOW FIELDS - FORCEDATA CFDOV) ASSUMED" 


In a Summary sort» only one OVERFLOW indicator may be 
described. The OVERFLOW indicator last described differed>» 
either in output record position or indicated literals» from 
the first OVERFLOW indicator described in ‘the input 
specifications. This field will be altered to describe a 
FORCEDATA field. 


"CONSTANT AND FIELD LENGTHS DIFFER™ 
in the current free format INCLUDE or DELETE statements the 
length of the constant specified is different than the given 
fietd length. | 
"CONSTANT FROM FREE FORMAT INPUT WILL BE TRUNCATED™ 


An INCLUDE or DELETE statement is being interpreted to free 


format syntax due to the TEACH command. It contains a. 
constant greater than 20 characters in tLength. This 
indicates the statement was specified in free format 


originatly. The constant will be truncated to 20 characters. 
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“DIFFERENT CONTROL FIELD LENGTHS: ACTUAL <INTi> SPECIFIED <INT2>" 


The control field length specified in the fixed or free 
format header statements differs from the actual maximum sum 
of the control fietds described for any record type. The 
values in bytes for these figures are given in this warning 
message» (denoted here by <INT1> and <INT2>). 


"DIFFERENT OUTPUT RECORD SIZES: ACTUAL <INT1L> SPECIFIED <INT2>" 


The output record size specified in the fixed format header 
statement or the free format FILE statement» differs from the 
actual maximum output record size described by the field type 
statements of each record type. The values tn bytes for 
these figures are given in the warning messages» (denoted here 
by <INT1> and <INT2>)._ 


"DROP CONTROL ASSUMED = COLUMN 28 NOT X" 


In the fixed format header card» cotuan 28 does not contain 
an "X" or a blank. Controt fields witt be dropped froe the 
output file. 


"INPUT FILE <FILE NAME> MISSING" 


An open was attempted on the disk file specified in this 
statement» (Cdenoted here as <FILE NAME>)» but the file was 
not found on disk. : 


“INVALIO CONTINUATION - OR ASSUMED" 


In the current fixed format INCLUDE or DELETE statement (*I" 
or "0" Coluan 6)» column 7 does not contain either an “A"%» 
"QO", “*" or a blank. The current INCLUDE/DELETE staterent 
widi be "OR"ed with the previous INCLUDE/DELETE. 


"INVALID FACTOR-2 TYPE = CONSTANT ASSUMED" 


In the current fixed format INCLUDE/DELETE statement» coluan 
19 does not contain a “"“C™ or "F* indicating constant or 
fields respectively. It witl be assumed that FACTOR~-2 will 
be described with a constant. 
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"INVALID OVERFLOW LENGTH" 


In the current fixed or free format summary statements the 
overflow length given is tess than the field Length 
indicated. The field length wittl be used as the output 
length for this field. b ° | 3 


“INVALID SORT TYPE - ASSUMED TO BE SORTR™ 


In the fixed format header cards columns 7712 do not contain 
either “SORTR*» *"SORTRS* or “SORTA®™ Left justified. “SORTR*» 
a tag-along sorts 1s assumed. 


"MORE THAN ONE OVERFLOW FIELD (FSV) - FORCEDATA (FOV) ASSUNED" 


More than one overflow field C("FSV" column 678) has been 
described in the current record type description. It will be 
aitered to describe a FORCEDATA C*FDV™ column 678) field. 


"NO VALID ALTSEQ STATEMENTS FOUND" 


The fixed format header card contained an "S" in column 26 
indicating an alternate collate statement is to be specified. 
No fixed or free format collate statement was found. 


"NUMBER OF SUMMARY FIELDS IS INCONSISTENT™ 


A different number of SUMMARYDATA fields (C("FS" cotuan 6-7) 
has been described tn the current record type than was 
defined in the first record type description containing 
SUMMARYDATA or OVERFLOW fields (C"FSV" colunan 678). 


"RECORD SIZE ALTERED OVE TQ TAGSORT - 4 Pee 


The maximum sum of the key and data ‘fields (data only if drop 
control is specified) is not equal to 4 bytes. The output 
record size wilt be 4 bytes and will contain the relative 
record pointers to the sorted file. 


"SEQUENCE NUMBERS ARE OUT OF ORDER 


The current fixed format sequence number given in coluans 1°5 
is tess than or equat to the previous sequence number . The 
order of the input cards witt not be amree eos 
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"SHOULD DROP CONTROL FIELDS OUE TO ALTERED DATA® 


The input specifications contain one of the following: 
- control fieids to be sorted in descending order 
- control fields defined to be of signed type 
- an alternate cotlating sequence 


Any of these conditions wilt cause the control fields to 
contain attered data. Control fields should be dropped from 
the output file. | 


"SIGNED FIELD USED WITH COLLATE = ALPHA ASSUMED®™ 


In the current fixed or free format INCLUDE/DELETE statement» 


the type specified is signed» ise.» SA» SN» RSN» RSA» P or Ue 
Coltating cannot be performed on a signed field. The type 
wilt be changed to wuneranee alpha. 


"SUMMARY FIELD IS INCONSISTENT™ 


The previous SUMMARYDATA fietd ("FS" coluan 6°77) differs from 


its corresponding SUMMARYDATA field in the first record type 


description containing SUMMARYDATA or OVERFLOW fields C"FSV" 
coluan 6°78). Either the output record positions or the 
specified literals differ. 


"TOO FEW FIXED CARDS®™ 


A number was specified in the FIXED statement indicating that 
number of fixed foraat records would foltow. An END“OFTFILE 
condition was found before that nusgber was reached. 


a ee 


An. 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP 81800/B1700 SORT/UTILITY 


SANTA BARBARA PLANT = P.S. 2222 2562 CA) 


«SEQUENCE SPECIFICATIONS 


ALTERNATE COLLATING SEQUENCE 

To change the standard collating sequences an "Ss" is coded in 
column 26 of the header specification and “ALTSEQ"” is coded in 
the first six positions. As many ALTSEQ statements as needed may 
be used; each statement aust begin with ALTSEQ and can contain a 
gsaximuam of 96 positions. 


NOTE: Do not use a packed or unpacked factor“1 in an include or 
omit record type speci fication (P or U in cotumn 8) 1f the 
alternate collating sequence is specified. 


CODING RULES 


1) ALTSEQ is placed in the first six positions to indicate to 
disk sort that the standard. collating sequence is being 
altered. 
123 4 5 6 
PAULATIS¢UENMQ? Ft tat t bb) dg a 
2) The next two positions are Left blank. 


12345678 


HAILETISTEIQIOID! ittitt itt (b = blank) 


3) Enter the hex equivalent of the character being taken out o f 
normal sequence. | 


1234567 89 1090 


IAILITISHENQI 1 thint tt tt tt Chn = hex nuaber) 
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4) Enter the hex equivatent of the value’ the character 


specified in coluans 9 and 10 is to assume in the collating 
sequence. : | ; 


12345678910 11 12 


PAILITISTEPQ! ft thi nt hit nt t tf t Chon = hex nusber ) 


5) Use as many pairs of 3) and 4) as the number of characters 
being taken out of normal sequence. 


6) No spaces are left between sets of hex numbers. 


123456 78910 11 12 1314 15 16 


fAULETISTETQH F thi nt At nt hi nt hi al 


7) Further specification lines are used to continues fotlowing 
the rules indicated in 1) through 6). 


8) =A double asterisk is used in positions 1 and 2 to indicate 
| the end of the ALTSEQ statements. 


423456789 10 11 12 13 1415 16 


VAULATISTEDQI § thi ni hi nt hi val hi nl 


~—EATLAITISUELQ! Fo tht ni ht nt ht ni fi ni 


DAILITISIEIQH § thi nt hi nf ht nt ht at 


fetet PF tit t tt &€ £& £ FF § Ft 
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INPUI ORDER 


Input to indicate use of the alternate collating sequence aust be 


in the following order: 


Sequence Specifications 
ae Header tine 
be  ALTSEQ statements 
Ce. xk 
de Record type Lines as required | 
e. Field description lines as required 


NOTES: A character being moved into a sequence position assigned 

| to another character wilt occupy the same position and 

are considered equal (see ALTSEQ Statements» Example 1). 

if the characters are not to be equal» the character that 

normatty occupies the position must also be moved (see 
ALTSEQ Statements» Example 2). 


 ALTSEQ statements can change: 
| le Factor“1 and factor-2 | 
2. Normal and opposite control fietds 
3. Control field characters before they are 
replaced or added to by forced fields 


ALTSEQ statements cannot change: 
le Data fields in records 
2. Forced control field characters 


SAMPLE ALISEQ STATEMENTS 


Example 1: To change the sequence of one character: 


—ALTSEQ ALTSEQ 4OFO 
Statewsents & * 


Explanation: Blank (49) is moved to the position in the 
collating sequence occupied by zero (F0)- 
Blanks and zeros are» therefore» consider= 
ed equal. | | 
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Exaaple 2: To change the sequence of several characters: 


ALTSEQ ALTSEQ SBCBCBCICIDL 
Statements kk 


Explanation: 5BC8& moves $ (58) to the position occupied 
by H (C8). 
C8C9 moves H (CB) to the position occupied 
C9D1 moves I (C9) to the position occupied 
by J (D1). a a 
The $ is inserted between G and H as follows: 
AeBeCoDob oF »eGoSeHs ls (1 and J occupy the 
same position) | ; | 
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EQRCED-FIELD SORTING PROCEDURES 


Defining a Conditional Force Character 
1. Fitl in coluans 1-6 as they would normally be filled in. 


2% Put an F in coluan 7. 


36 Define the position of the control fietd for the input record 
in columns 13-16. | 


4. Enter the character that is to be replaced in column 17. 


S- Enter the character that is to replace it tn cotuan 18. 


Defining a Force-ALl Character 
Le Fittl in coluans 17-6 as they would ey oe be filled in. 
2e Put an F in -coluan 7. | 


3. Put the character which replaces the controt field in cotuan 
18. 


4. Enter the character that is to be replaced in coluan 19. 
(The character entered in column 19 inforas the disk sort 
that the line is a continuation of the preceding line.) 


5. Leave columns 9°17 blank. 

If a forcerail line is not placed after a conditional force tine 
and the sort program does not find the specified characters in 
the control field of the input records the program | 


Replaces the control field character with @aFFQ if ascending 
sequence 1s speci fied in the header line. 


* Replaces the control field character with ave. if descending 
sequence ‘1s specified in the header Line. . 

Qefining an Unconditional force Cha aracter 

1. Fill in evans 1-6 as they would normally be filled in. 


2e Put an F tn coluan 7. 
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3. Put the character which replaces the control field tin columns 


18. 


4. Leave columns 9°17 blank. 


Specifying an Overflow Indicator Field 
le Fill in columns 1°6 as they would normattly be filled in. 
Ze Put an S in coluan 7. | 


3 Put a V in coluan 8. 


4. Enter a character in coluan 17 if replacement with 


an 


asterisk (*) is not desired. If overflow occurs itn any 
summary data field in the records the initial value of the 
overflow field is replaced by the character in coluan 17. 

5S. Enter a character in cotuan 18. If none of the summary data 
fields overflow» the overflow field will contain the 
character specified in column 18. 
NOTE: Onty one overflow indicator may be defined for all 


record types. 
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QAMPLE JOB ONE 
 <header type> 
<pecord type> 


: _ <field type> 


SAMPLE JO8 IWO 


<header type> 
<field type> 


© SAMPLE JOS IHREE 


<header type> 
- <€record type> 


<field type> 


SAMPLE JOB £QUR 
<header type> 
<record type> 


<field type> 


<record type> 


; © field type> 
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SAMPLE JO85 


CONTROL 10 

INCLUDE (69 LEQ 40 6 DIGIT) 

KEY €7 4 A UA) C1 6 A UA) 

DATA (11 14 UA) €28 2 VA) (30 5) 


(46 5) (69 6) (81 6) (87 5) 
C92 5) €75 6) © 


TAGSORT 
CONTROL i0 


KEY (7 4 UA) (1 6 OIGIT) 


DROP CONTROL 
CONTROL 7 


INCLUDE (7 LEQ "0130" 4 DIGIT) AND 


(7 GEG "0126" 4 DIGIT) 


KEY (7 4 UA) 097 3:0 DIGIT) 


DATA (1 6) C7 4) (C97 3) €106 6) 


CONTROL 13 

INCLUDE (1 EQL "R™ UA ) 
FORCEKEY ("™1%) 

KEY (6 6 DIGIT) 7 
DATA (2 49 €12 5) (17 6) €23 5) 
INCLUDE (1 EQL "I" UA) 


FORCEKEY ("2") 


BURROUGHS CORPORATION 


COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


<record type> 


<field type> 


SAMPLE JOB ELVE 


<header type> 


<record type> 


<field type> 
SAMPLE JOB SLX 
<header type> 


<record type> 


<field type> 


SAMPLE JOB SEVEN 
<header type> 
<record type> 


<field type>. 
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KEY €2 6 DIGIT) €28 6 DIGIT) 
DATA (8 5) €13 7) (20 8) €34 1) C35 5) 


INCLUDE C1 EOL "At: UA) 
FORCEKEY ("3") 


KEY (2 6 DIGIT) 
DATA €8 1) (9 5) C24 4) €18 6) 


SUMMARIZE 
CONTROL 6 


INCLUDE (C1 EQL “"A™ UA) 


KEY €2 6 UA) 


SUMMARIZE 


CONTROL 7 


INCLUDE (1 EQL "I" UA) 


KEY C13 7 UA) 

FORCEDATA (" “) C™#") | 
SUMMARYDATA €40 3 DIGIT) 
FORCEDATA (" “) €"™$") 
SUMMARYDATA €43 8 RSA) 
OVERFLOW (X) 


DROP CONTROL 
CONTROL & 


DELETE (23 EQL "X") 
INCLUDE : 


KEY C15 8 RSA) 
DATA (1 23 UA) 
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FILE INVETORY CDISK DEFAULT) INVYRO4 CTAPE 111 10) INVYROS 
(TAPE 111 10) INVYRO2 CTAPE 111 19) INVYROL 
CTAPE 111 10) OUTPUT CDISK DEFAULT) 


<header type> CONTROL 13 


<record type> 


INCLUDE (7 EQL "0126" 4 DIGIT) AND 
(87 EQL "00023" 5 DIGIT) OR 


(7 EQL "0126" 4 DIGIT) AND ~ 
(87 EQL "900198" 6 DIGIT) OR 
(7 EQL "0126" 4 DIGIT ) AND 


(87 EQL 701120" 


<field type> 


DATA (7 4) (97 3) €166 6) 


SAMPLE JOB NINE 


<header type> CONTROL 6 
<record type> 
| (87 LEQ 
(87 GTR 

C45 EQL 

(45 EQL 


KEY €1 6 DIGIT) 


<field type> 
7 DATA (7 105 UA) 


INCLUDE (44 EQL 


wg 


= 


eO% 


wa? 


wRge 


DIGIT) AND 
RSN) AND 


~RSN) AND 


ZONE) AND 
DIGIT) 


5 DIGIT) 


KEY €104 2 A UA) (87 5) C1 6 DIGIT) 


sDisplacement 
sspecified tn 
sbytes 
sDisplacement 
sspecified in 
sbytes 


is. 
hat f 
1s 
half. 
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DAIA SIRUCTURES 


DYNAMIC MEMORY USAGE 


Dynamic memory is allocated from two stacks which run together. 
Permanent memory spaces are at low address (the beginning of 
dynamic memory) locations. Temporary spaces are allocated from 
the limit register down and each piece has an associated length 
fietd of 16 bits. This adlows temporary chunks to be returned 
either one at a time in a LIFO manner or all at once. Returned 


areas are zero filled. 


Permanent space is used for ID KEYS»  F-KEYS and the collate 
table. Temporary memory is used for record buffers» temporary 
constants and ati short duration items. an 


LINKED DATA STRUCTURES 


A linked list structure is created internatly by SORT/UTILITY and 
stored in permanent dynamic memory. It 18 created from the input 
specifications and used tn processing the work and output files. 
The linked list its made up of "KEYS". There are two types of 
keys: the ID.KEY which holds all information needed to describe 
an INCLUDE/DELETE type statement and the F.KEY which holds atl 
information needed to describe a field type statement Cieee» KEY» 
FORCEKEY» DATA» FORCEDATA» SUMMARYDATA» or OVERFLOW). 


There are various chains running through the tinked List (see 
figure D-1). The primary chain links are ID-KEY and F.KEY 
entries. The head of this chain is caited ID.HEAD. ID-HEAD 
points to the first ID.KEY. ALL IDe-KEY*s are Linked together by 
the field IOD.LINK.  $$The IDF.LINK fietd of each ID-KEY links 
FeKEYS to their associated I[D.KEY's. That is» all IDO-KEY*s 
describing INCLUDE/DELETE statements of the same record type have 
the same ID.~F-LINK pointer. This IDeFeLINK pointer potnts to the 
first FeKEY describing a field statement for this record type. 
FeKEY's of a record type are Linked by the F.LINK field. <A vaiue 

of -1 indicates the end of a linked List. 


The summary keys chain is initiatly pointed to by the pointer 


SeHEAD. This chain is made up of F.KEY entries describing 
SUMMARYDATA statements of the first record type description 


containing SUMMARYDATA or OVERFLOW statements. These are the 


SUMMARYDATA statements that define any summarizing to be 


per foraed. 


The GI-PTR field points to an FeKEY describing an OVERFLOW 
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statement» if there is one. This statement must also be defined 


in the first record type description containing summary 
information. If both SsHEAD and OI.PTR have a value of -l» there 
are ono SUMMARYDATA or CVERFLOW statements in. the input 
Speceteebr ons: | _ 


At a mininums there will be one ID. KEY and one FeKEY entry itn 
this linked list structure. One extra ID-KEY entry will exist 
which will not represent an INCLUBDE/DELETE statement» unless the 
tast INCLUDE/DELETE was an INCLUDE ALL statement or = an implied 


INCLUDE ALL situation existed. In other words» if there are no 


INCLUDE or DELETE statements in the input specificattons» there 
wilt be only one ID. KEY entry in the linked list representing an 
INCLUDE ALL- If the last INCLUDE/DELETE was an INCLUDE ALL 
statement» the number of ID.KEY entries witt equal the nuaber of 
INCLUDE/DELETE statements- In att other cases there will be one 
more ID-KEY entry than INCLUDE/DELETE statements» and the extra 
will be the Last IOD-KEY. | 


The tast ID.-KEY entry of the tist witt only point to F.KEY 
entries (by way of its ID.FeLINK field) if it represents an 
INCLUDE ALL situation or statement. 


wen a a a ee AA ae bed eS ee Rak ae ee os 


ant iw Rete ae Se Se 
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ID.KEYCO] 


ID. HEAD "> PIDsLINKIIDeFeLINK! 


ID.KEY€2] REPRESENTS 
AN "INCLUDE ALL” 
STATEMENT 
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FeKEYCO] 


|-----> IF. LINKES LINKS 


prmm>iF eLINKIS LINK! 


ft -1 ¢% 1 «89 


J cece w wae jf oerssesere| | | Jose ocefoncnn-| 
§<7--]| i (sse>1 I<--] 1 1 49 
f° feeeecee [esse ere~ =| a | power ce| coeeen| 
i . i ' 
i ID-KEYCL3} qf FeKEYC1) 
i pease a= | Sse See's] i : [oS er ee] <See ee) 
geen IDO-LINKIID.F LINKS i Inm—> IF eLINKES-LINKE <""SHEAD 
[Psoss see (ores e ee 1 [=esee=[ereee=| 
L<sseeee" 7 ' pse'<> | i<--] t jo-~>] 
{ (Sasa eee (Sessa eee= =) i Jpowores | coer -{ i 
{ i - ! 
i j FeKEYC2) i 
i A VALUE OF -1 fo |eereee Jor----5 I 
i INDICATES THE f-->IF eLINKIS.LINKE<-<-1 
! END OF A CHAIN eee ees ae 
' I<--ti wc 
i | pssee>= (sssee"{ 
| 4 
i i FAKEYEC 3] 
i i procs coporesret 
P--> IF LINK SSLINKE <--O1.PTR 
i [seSseea | sseerrt 
i § -1 4 1 #4 
i (esse e= (Sees. -, 
j 
i 
i ID.KEYC2] kk egeeneeneveeneseneeaneagen en ese eee eneann eon eoene 
ee oe es : FeKEYC4) ‘ 
Fee LT ID.LINKIID.F LINK! ° [oes <2 | -s2S<=) ° 
| [sesee=<[-s-— 3 eee | promo weeernn> IF ALINKIS LINK! e 
! “1 1 i-->] [se ses< [See e =): . ° 
Jose seen] coerce enn | i<---] i wl if ° 
1 [See esei ese se2 h. ; ° 
wee IDKEYC2) Wilt ONLY { FeKEYC5] ° 
POINT TO F-KEYS IF j joseeee | oSee =e © 
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Figure D-1: INTERNAL KEYS CHAIN AFTER SYNTAX PHASE 
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RECORD PROCESSING 


paeaee 


work records are built with keys on the right and relative record 
pointers on the left. Relative record pointers are eight decimal 


digits» 4 bytes» long. SORT is catled with the work fite as” 


input and the output file as output. The keys are truncated when 
the output file is written because its record size is four 
characters. No output pass ts donee. , 


RECORD 


Work records are built with input file nuaber » relative record 


pointer» record type key pointer» and keys. SORT is calted with 
input and output file of WORK. An output pass uses information 
from the work records to create the output records by 
tagsearching the original input records. 


SUMMARY 


Processing is the same as a record sort except during the output 
passe The key of each work record is compared to the next. When 
they are equal» the summary fields are added together. An output 
record is written when they are not equal. | 
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FILE AITRIGUTE ASSIGNMENT PRECEDENCE 


File equates specified at execution time will override fite 
statement specifications for the following attributes? 


RECORD SIZE 
RECORDS PER BLOCK 
BLOCKS PER AREA 
AREAS 
NAME 
HARDWARE 


The file statement will override for the following attributes: 


WARTABLE 
CODE TYPE 
PARITY 
MULTI PACK 


Missing attributes» those not specified by file equates or a FILE 
statement» will be given SOL defaults unless the file is on disk. 
If the fite is on disks the attributes will come from the disk 
file header. The SOL defaults witt be taken from the FPB of a 
file with the internal name of "DEFAULT". | 


If the file is to be included in SORT/UTILITY's input datas» 
either the name field, FBP.NAME S» or the hardware’ fitetd» 
FPB.HDWR» must be altered in an input fite's FPS. 
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RESTART PROCEDURES 


If the statement “RESTART” 1s specified in the tnput 
specifications» the SORT/UTILITY run will be made “restartable". 
This allows the user to restart the job at various points in case 
of an abnormal terminate. A SORT/UTILITY run is restarted by 
specifying "RESTART" fotitlowed by the abnormally terminated 
SORT/UTILITY*s job number. | : | oo | 


A SORT/UTILITY run is divided as follows: 
FIRST PASS SYNTAX ANALYSIS. 
| INPUT FILE VERIFICATIONS 
GENERATION OF WORK FILE 
SORT 


SECOND PASS: GENERATION OF OUTPUT FILE 
(last pass) 


If the SORT/UTILITY run has been specified as restartable, and 
the program abnormatiy terminates before the end of the first 
passe the restarted job wilt resume at the beginning of the first 
passe | | 


If the job abnormatty terminates during the SORT phases the 


restarted job will RESTART the SORT phase» skipping everything in 


the first pass except the syntax analysis. 


If the SORT/UTILITY run abnormally terminates in the last pass» 
the restarted job will resume at the beginning of the last pass» 
skipping everything before that except the syntax analysis. The 
syntax analysis wtlt always be performed. 


when a job is being restarted» it is also being made restartable. 


Hm1 


BURROUGHS CORPORATION — COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | 
SANTA BARBARA PLANT P.Se 2222 2562 CA) 


SWO=1 


SW1i=1 


SW2=1 


B1800/81700 SORT/UTILITY 


PROGRAM SWITCHES 


Causes the specifications (usually a CARDS file) to be 
read from the accept queue. A blank accept terminates the 
input. | 


If errors are detected in the specifications» they will be 
written to the ERROR.LINE file. | 


This switch setting makes the SORT restartables. ands if 


the last 24 bits of the program switches are not zeros a 
restart of the specified job number is effected. This 


cannot be used when debugging. 


Debugging | 
Trace (print) alt of the conditional halts to the LINE 
file. 

Print all tokens found by GET. TOKEN- 

Print contents of keys and FPB*s when they are accessed. 
Allows haiting at a sequence number specified in the. 
rightaost 24 bits of alt the progras switches. 
Combinations of values may be used. 
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SAMPLE JOB FIVE C-2 

SAMPLE JOB FOUR C-i1 
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SPECIAL OPTIONS 2-2 | 
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